Penrith Beacon WCP — Docker containers, images, and Docker Hub browser for local and NAS hosts.
1.1K
A Widget Context Protocol (WCP) widget that brings full Docker management into any WCP-compatible dashboard. Monitor and control containers and images on your local machine and a remote NAS, browse Docker Hub repositories and tags.
Specification: widgetcontextprotocol.com | Part of the Penrith Beacon WCP widget suite.
WCP 2.1.0 certified. Full theme reception, orchestration-aware state, Publish to Web, WCP export.
| Component | Default size | Description |
|---|---|---|
| Local | 12x6 | Local Docker host — containers and images |
| NAS | 12x6 | Remote NAS Docker host via wcp-docker-agent |
| Hub | 12x6 | Docker Hub repositories and tags browser |
| Settings | 12x6 | Docker Hub credentials, NAS agent URL and token |
docker run -d \
--name wcp-widget-docker \
-p 3744:3744 \
-v /var/run/docker.sock:/var/run/docker.sock \
-v docker_data:/app/data \
-v docker_published:/app/published \
-e CONTAINER_NAME=wcp-widget-docker \
--restart unless-stopped \
docker.io/penrithbeacon/wcp-widget-docker:latest
services:
docker:
image: docker.io/penrithbeacon/wcp-widget-docker:latest
container_name: wcp-widget-docker
ports:
- "3744:3744"
volumes:
- /var/run/docker.sock:/var/run/docker.sock
- docker_data:/app/data
- ./published:/app/published
environment:
- CONTAINER_NAME=wcp-widget-docker
restart: unless-stopped
volumes:
docker_data:
Local tab: Works automatically when the Docker socket is mounted.
NAS tab: Requires wcp-docker-agent running on the remote host. Configure the agent URL and bearer token in Settings.
Hub tab: Requires Docker Hub username and password/PAT in Settings.
| Header | Required | Description |
|---|---|---|
Wcp-Instance-Id | Yes | Unique card instance identifier |
Wcp-Dashboard-Id | Yes | Dashboard installation identifier |
Wcp-Version | Yes | WCP protocol version of the requesting dashboard |
Wcp-Widget-Id | Yes | Widget identifier within the dashboard |
Wcp-Orchestration-Id | No | Active orchestration identifier (for state scoping) |
Wcp-Application-Id | No | Active application identifier (for state scoping) |
| Endpoint | Description |
|---|---|
GET /wcp | Container Directory — WCP two-tier discovery |
GET /widget/wcp | Widget Manifest with runtime publish status |
OPTIONS /wcp | CORS preflight (all widget routes) |
GET /widget/ | Compact widget card (iframe) |
GET /widget/index | Widget Index — lists all controls |
GET /widget/health | Health check with container name |
GET /widget/icon.svg | Widget icon (SVG) |
GET /widget/api/guids | Component UUIDs for orchestration binding |
GET /widget/local | Local Docker host page |
GET /widget/nas | NAS Docker host page |
GET /widget/hub | Docker Hub browser page |
GET /widget/settings | Settings page |
GET /widget/api/local/containers | Local containers list |
GET /widget/api/local/images | Local images list |
POST /widget/api/local/containers/<cid>/<action> | Local container action (start/stop/restart/remove) |
GET /widget/api/nas/containers | NAS containers list |
GET /widget/api/nas/images | NAS images list |
POST /widget/api/nas/test | Test NAS agent connection |
POST /widget/api/nas/containers/<cid>/<action> | NAS container action |
GET /widget/api/hub/repos | Docker Hub repositories |
GET /widget/api/hub/repos/<name>/description | Repository description |
GET /widget/api/hub/repos/<name>/tags | Repository tags |
GET /widget/api/settings | Current settings (tokens masked) |
POST /widget/api/settings | Save settings |
GET /widget/export.wcp | Self-export as .wcp package |
POST /widget/publish | Accept SPA HTML for Publish to Web |
DELETE /widget/publish | Remove published SPA |
GET / | Serve published SPA (if present) |
| Property | Value |
|---|---|
| WCP Version | 2.1.0 |
| Widget Version | 1.4.0 |
| Render mode | iframe |
| Auth | None (credentials stored server-side) |
| Default card size | 12x6 |
| Multi-instance | Yes (per Instance-Id) |
| Property | Value |
|---|---|
| Base image | python:3.12-slim |
| Platforms | linux/amd64, linux/arm64 |
| Port | 3744 |
| Framework | Flask |
| Dependencies | Flask, requests, docker |
| Persistent storage | Named volume for settings |
| Tag | Description |
|---|---|
latest | Most recent stable release |
1.4.0-wcp2.1.0 | /widget/index directory page, audit compliance |
1.3.0-wcp2.1.0 | /widget/health returns container name |
1.2.0-wcp2.1.0 | WCP 2.1.0 upgrade, orchestration ID context |
1.1.0-wcp2.0.0 | Container block, manifest image source |
1.0.1-wcp1.4.0 | Server UUID, Container Directory, Wcp-Widget-Id |
1.0.0-wcp1.3.1 | Initial release |
Content type
Image
Digest
sha256:6eff47f89…
Size
47.5 MB
Last updated
4 months ago
docker pull penrithbeacon/wcp-widget-docker