Docker Widget

Lists all Docker containers on the host with their name, image, status, and uptime.

Requirements

• Docker must be running on the host
• The server process needs read access to the Docker socket

Docker socket access

Docker Compose (recommended):

volumes:
  - /var/run/docker.sock:/var/run/docker.sock:ro

Manual / development:

Ensure the user running the server is in the docker group:

sudo usermod -aG docker $USER

Configuration

No API key required. The Docker socket path defaults to /var/run/docker.sock and can be overridden with the DOCKER_SOCKET environment variable.

Key	Type	Default	Description
hideHeader	boolean	false	Hide the widget title bar
defaultCollapsed	boolean	false	Start collapsed

Troubleshooting

No containers shown

• Check the Docker socket is mounted and the path is correct
• Verify the server has read permission: ls -la /var/run/docker.sock
• Look for connection errors in the server logs