← All docs

Docker & Portainer

The Docker widget shows your containers at a glance: a coloured state dot, name, image and status, grouped per environment, with a header pill counting what is running.

It reads containers from one of two sources:

  • Docker Desktop (default) — the local engine. Nothing to configure.
  • Portainer — for containers on remote hosts, across every environment Portainer manages.

What you’ll need

  • Nothing for local Docker Desktop, which is the default.
  • For Portainer: the base URL of your Portainer instance, plus an access token — create one under My account → Access tokens.

Pick the source in the widget’s ⚙ panel. A Portainer token is stored in Windows Credential Manager, never in a config file.

Controls

Controls are off by default. Turn Enable controls on in ⚙ to start, stop and restart containers directly from the widget.

Leave it off if the widget is on a screen you share or present from — with controls disabled the widget is strictly read-only.

Display options

SettingOptions
Stopped containersShow dimmed · Count only · Hide
Containers shown at once5 · 8 · All
Cycle through containersOn/off, with a 3s / 4s / 6s interval

Cycling is useful when you watch more containers than fit the widget size you’ve chosen.

Full step-by-step guide lands with the public beta.