Skip to content

018-Dockhand

DockerLabs Banner


Lab 018 - Dockhand: Docker Management UI


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.

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
docker ps --filter name=dockhand

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:

docker compose up -d

Verify:

docker compose ps

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:

docker compose up -d

05. Exploring the UI

Once Dockhand is running, open http://localhost:3000 and explore:

  1. Dashboard — Overview of all environments with resource tiles
  2. Containers — List, start, stop, restart, remove, inspect containers
  3. Stacks — Manage Docker Compose stacks visually
  4. Images — View, pull, and scan images for vulnerabilities
  5. Volumes — Browse and manage Docker volumes
  6. Networks — View and manage Docker networks
  7. Terminal — Open a web terminal into any running container (no SSH needed)
  8. 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:

  1. Go to Stacks → Add Stack → Git Repository
  2. Enter your repository URL (SSH or HTTPS)
  3. Select the branch and compose file path
  4. Optionally configure a webhook for auto-deploy on push
  5. 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 container
  • dockhand.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
Browser → Dockhand ← Hawser Agent → Docker
Setup
  1. In Dockhand, go to Settings → Environments → Add Environment → Hawser
  2. Copy the generated token and run command
  3. On the remote host, run the Hawser agent with the provided token
  4. The environment appears in Dockhand once connected

08. Clean Up

# Stop and remove Dockhand
docker compose down -v

# Or if using docker run:
docker stop dockhand && docker rm dockhand
docker volume rm dockhand_data