Tools & Add-onsAdd-ons
Dockhand
Run Dockhand, a Docker management UI, as a Docker Compose project on an existing Docker host.
dockhand.sh writes a small Compose file for the fnsys/dockhand:latest
image and starts it.
| Run it | Inside the container or VM that runs Docker. The script has no Proxmox VE host check |
| Requires | Docker and the Compose plugin, already installed. Missing either one exits with code 1; the script does not offer to install Docker |
| Supported OS | Not checked |
| Port | 3000 by default, asked at install |
| Source | tools/addon/dockhand.sh |
Run
bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/tools/addon/dockhand.sh)"Prompts
On a system without /opt/dockhand/docker-compose.yaml:
| Prompt | Answer |
|---|---|
Enter port number (default: 3000): | Host port for the web UI. Empty keeps 3000 |
Install Dockhand? (y/n): | y installs. Anything else prints Installation skipped |
When the Compose file exists:
| Prompt | Answer |
|---|---|
Update (1), Uninstall (2), Cancel (3)? [1/2/3]: | 1 updates, 2 uninstalls, 3 cancels. Anything else prints Invalid input |
What it creates
| Item | Value |
|---|---|
| Compose project | /opt/dockhand/docker-compose.yaml |
| Container | dockhand, restart policy unless-stopped, host port mapped to container port 3000 |
| Mounts | /var/run/docker.sock and the named volume dockhand_data at /app/data |
| Address | http://<ip>:<port> |
| Credentials | None. Dockhand's first-run wizard creates the admin account |
Update
Run the script again and answer 1. It runs docker compose pull and
docker compose up -d --remove-orphans in /opt/dockhand.
The script has no type=update mode and does not create a
/usr/local/bin/update_dockhand helper, so the container's update command
does not offer Dockhand.
Remove
Answer 2. It runs docker compose down --remove-orphans and deletes
/opt/dockhand. The data volume stays; remove it with:
docker volume rm dockhand_dataLimits
- The container gets the Docker socket, which is full control over the Docker host.
- The image tag is
latest; there is no version pin.