2.0.0 (2025-07-23)
BREAKING CHANGES
Version 2 introduces a new configuration database for Dockman that will store all application-related data going forward.
Required Action for V2+ Users:
All users upgrading to V2 or later must add the following mount to their Docker Compose configuration:
# docker compose sample
services:
dockman:
container_name: dockman
image: ghcr.io/ra341/dockman:latest
environment:
- DOCKMAN_COMPOSE_ROOT=/path/to/stacks
volumes:
# these mounts can now be removed
# - ./config/ssh:/app/config/ssh
# - ./hosts.yaml:/app/config/hosts.yaml
# 4️⃣ NEW: Mount config directory for database storage
# DO NOT store this in dockman compose root
- /path/to/dockman/config:/config # <--- add this line
ports:
- "8866:8866"
restart: always
Migration Steps
-
Stop your current dockman container
docker compose down
-
Update your docker-compose.yml with the new config volume mount (see example above)
-
Remove your old host.yaml file (it's no longer needed)
rm /path/to/your/host.yaml
-
Start dockman with the new configuration
docker compose up -d
-
Reconfigure your multihost settings through the UI instead of the YAML file
Breaking Changes
⚠️ Important Notes:
- Your existing SSH keys will not be automatically migrated
- You'll need to re-add your remote hosts through the web UI
What's Improved
- Simplified configuration management
- All settings managed through the web interface
- Better persistence with database storage
- No more manual YAML file editing