Docker Manager

Docker Manager

Manage Docker containers across the home lab fleet.

Docker Hosts

Commands

Container status

# All containers
python3 docker_manager.py status

# Running only
python3 docker_manager.py status --running

# On specific host
python3 docker_manager.py status --host server

Container operations

python3 docker_manager.py start <container>
python3 docker_manager.py stop <container>
python3 docker_manager.py restart <container>
python3 docker_manager.py logs <container> [--lines 50]

Image management

python3 docker_manager.py images
python3 docker_manager.py pull <image>
python3 docker_manager.py rmi <image>

Cleanup

# Remove stopped containers, unused images, build cache
python3 docker_manager.py prune

# Aggressive cleanup (including volumes)
python3 docker_manager.py prune --volumes

System info

python3 docker_manager.py info
python3 docker_manager.py disk

Workflow

"Container won't start"

1. Check status: python3 docker_manager.py status --host server
2. Check logs: python3 docker_manager.py logs <container> --lines 100
3. Check disk: python3 docker_manager.py disk
4. Check image: python3 docker_manager.py images
5. Restart: python3 docker_manager.py restart <container>

"Disk is full"

1. Check Docker disk usage: python3 docker_manager.py disk
2. Prune: python3 docker_manager.py prune
3. Remove unused images: python3 docker_manager.py images then rmi old ones
4. Check volumes: docker system df -v

Docker Compose

# If using docker-compose files
ssh server 'cd /opt/<project> && docker compose ps'
ssh server 'cd /opt/<project> && docker compose up -d'
ssh server 'cd /opt/<project> && docker compose logs --tail 50'

Security

• Docker socket access = root — treat as sensitive
• Don't run untrusted images
• Use --read-only and --security-opt no-new-privileges for production containers
• Keep images updated for security patches
• Monitor container resource limits to prevent host exhaustion

Source: Danielhogben/hermes-skills — distributed by TomeVault.