Integrations

Container updates (What's Up Docker)

Show which containers have a newer image, with What's Up Docker.

The Container updates widget lists the containers whose image has a newer version, from the current tag to the new one, biggest jumps first (major, minor, fix), and the containers rebuilt under the same tag (a new digest). The container's name links to its release notes when the registry gives them.

NasDash reads what What's Up Docker (WUD) found; an administrator can start an update from the widget, through WUD.

Connect it

  1. Run What's Up Docker next to your containers; its API listens on port 3000.
  2. In NasDash, open Settings → Integrations → Container updates → What's Up Docker.
  3. Enter its address, for example http://nas.example.com:3000. If WUD's basic authentication is turned on, choose User and password and enter them.
  4. Save and test the connection, then add the Container updates widget and choose the connection.

What it reads

GET /api/containers, every five minutes, shared by every widget on the connection. The widget shows how many containers WUD watches, the updates, and how many containers WUD could not check (a private registry without credentials, for example). Only http and https links are kept.

Update from the widget

Administrators get an update button on each container, and Update all when several can be updated. It does what WUD's own button does: it runs the container's Docker or Docker Compose trigger, which pulls the new image and recreates the container, then asks WUD to check the container again. The update runs in the background; the widget shows Updating…, then Updated for two minutes, or Failed with the reason.

  • WUD needs a docker or dockercompose trigger for the container (WUD_TRIGGER_DOCKER_… or WUD_TRIGGER_DOCKERCOMPOSE_…). Without one, no button is offered.
  • With WUD's authentication on, the account needs the rw or admin role; a read-only account only lists updates.
  • A confirmation, on by default, says which version will be pulled and warns about major versions. Ask before updating in the widget settings turns it off.
  • The container stops for a moment while it is recreated. Updating NasDash or WUD themselves from the widget restarts what is running it.

Display and access

The number of containers shown (3 to 40) is set with a slider in the widget settings; the line under the list shows the others, and hides them again. Rebuilt images (same tag, new digest) and app icons can be hidden; the icons come from the dashboard-icons collection, loaded by the browser. Viewers need the Docker containers permission, like the container list. The public demo shows fictional updates.