018-Dockhand

Lab 018 - Dockhand: Docker Management UI
- In this lab we will explore Dockhand, a modern self-hosted Docker management platform
- Dockhand provides a web UI for managing containers, stacks, images, volumes, and networks
- It runs on minimal resources (Raspberry Pi compatible), uses SQLite by default, and has zero telemetry
- The lab covers installation, Docker Compose deployment, and key features
-
The lab is divided into several tasks:
- 02. Quick Start with Docker Run
- 03. Deploy with Docker Compose
- 04. Deploy with PostgreSQL Backend
- 05. Exploring the UI
- 06. Managing Stacks via Git
- 07. Multi-Host Management with Hawser
- 08. Clean Up
01. What is Dockhand?
Dockhand is a self-hosted Docker management platform that provides a modern web interface for managing your containers, stacks, images, volumes, and networks. It is designed for homelabs and enterprise environments alike.
- Source: github.com/Finsys/dockhand
- License: BSL 1.1 (converts to Apache 2.0 in 2029)
- Website: dockhand.pro
Features
| Category | Features |
|---|---|
| Container Operations | Start, stop, restart, remove containers; create with advanced config; view processes, env vars, resource usage; web terminal; file browser |
| Compose & Stacks | Visual Compose editor; deploy from Git repos; auto-sync on push with webhooks; re-pull & force redeploy; scheduled deployments |
| Observability | Live CPU & memory metrics; real-time log streaming with ANSI colors; container activity log; disk usage monitoring; email & webhook notifications |
| Security | OIDC/SSO (free); LDAP/AD; MFA (TOTP); RBAC; vulnerability scanning (Grype/Trivy); safe-pull protection |
| Multi-Host | Local Docker socket; remote TCP with TLS; Hawser agent for NAT/firewall traversal; environment switching |
| GitOps | Deploy from Git repos; SSH & HTTPS auth; webhook triggers; scheduled sync intervals; multiple repo support |
| Customization | Light/dark themes; configurable fonts; hide/show/reorder columns; resizable dashboard tiles; per-user preferences |
Dockhand vs Portainer
| Feature | Dockhand | Portainer CE |
|---|---|---|
| SSO/OIDC | Free | Paid (Business) |
| Vulnerability Scanning | Free (Grype/Trivy) | Paid |
| Database | SQLite (default) or PostgreSQL | Embedded BoltDB |
| Telemetry | Zero | Optional |
| Resource Usage | Runs on RPi 4 | Heavier footprint |
| License | BSL 1.1 → Apache 2.0 | Zlib |
| Git Stack Deploy | Free | Free |
02. Quick Start with Docker Run
Deploy Dockhand with a single command:
docker run -d \
--name dockhand \
--restart unless-stopped \
-p 3000:3000 \
-v /var/run/docker.sock:/var/run/docker.sock \
-v dockhand_data:/app/data \
fnsys/dockhand:latest
Then open http://localhost:3000.
Verify it’s running
03. Deploy with Docker Compose
Create a docker-compose.yml:
services:
dockhand:
image: fnsys/dockhand:latest
container_name: dockhand
restart: unless-stopped
ports:
- 3000:3000
volumes:
- /var/run/docker.sock:/var/run/docker.sock
- dockhand_data:/app/data
volumes:
dockhand_data:
Deploy:
Verify:
04. Deploy with PostgreSQL Backend
For high-availability setups, use PostgreSQL instead of SQLite:
services:
postgres:
image: postgres:16-alpine
restart: unless-stopped
environment:
POSTGRES_USER: dockhand
POSTGRES_PASSWORD: changeme
POSTGRES_DB: dockhand
volumes:
- postgres_data:/var/lib/postgresql/data
dockhand:
image: fnsys/dockhand:latest
container_name: dockhand
restart: unless-stopped
ports:
- 3000:3000
environment:
DATABASE_URL: postgres://dockhand:changeme@postgres:5432/dockhand
volumes:
- /var/run/docker.sock:/var/run/docker.sock
- dockhand_data:/app/data
depends_on:
- postgres
volumes:
postgres_data:
dockhand_data:
Deploy:
05. Exploring the UI
Once Dockhand is running, open http://localhost:3000 and explore:
- Dashboard — Overview of all environments with resource tiles
- Containers — List, start, stop, restart, remove, inspect containers
- Stacks — Manage Docker Compose stacks visually
- Images — View, pull, and scan images for vulnerabilities
- Volumes — Browse and manage Docker volumes
- Networks — View and manage Docker networks
- Terminal — Open a web terminal into any running container (no SSH needed)
- Logs — Real-time log streaming with ANSI color support and time range filtering
Try the Web Terminal
- Navigate to a running container
- Click the terminal icon to open a shell session directly in your browser
Vulnerability Scanning
- Navigate to Images
- Select an image and click “Scan”
- Dockhand uses Grype and/or Trivy to identify CVEs
06. Managing Stacks via Git
Dockhand can deploy and auto-sync stacks from Git repositories:
- Go to Stacks → Add Stack → Git Repository
- Enter your repository URL (SSH or HTTPS)
- Select the branch and compose file path
- Optionally configure a webhook for auto-deploy on push
- Set a scheduled sync interval if desired
Labels for Customization
Use Docker labels to customize Dockhand behavior:
services:
myapp:
image: myapp:latest
labels:
- "dockhand.url=https://myapp.example.com"
- "dockhand.order=1"
dockhand.url— Adds a clickable link in the UI next to the containerdockhand.order— Controls display order within stacks
07. Multi-Host Management with Hawser
Hawser is an open-source Go agent that lets you manage Docker hosts behind NAT or firewalls:
- The agent initiates outbound-only connections to Dockhand
- No exposed ports or inbound firewall rules needed
- Token-based authentication with auto-reconnect
How it works
Setup
- In Dockhand, go to Settings → Environments → Add Environment → Hawser
- Copy the generated token and run command
- On the remote host, run the Hawser agent with the provided token
- The environment appears in Dockhand once connected