How finsys/dockhand works
Dockhand is a web-based Docker management application. Users connect to Docker environments, inspect and operate containers and Compose stacks, and receive live status, logs, and metrics; the README also documents Git deployments, backups, vulnerability scans, schedules, and authentication. The map emphasizes those product domains and the API/server layer. Several capabilities are documented but their route-to-service wiring was not sampled, so those links are marked unverified rather than presented as observed calls.
Main entry points: components Management UI · backup-service.ts Backup execution · subprocess-manager.ts Worker manager · +server.ts Schedule API
Components 22
User experience
- Management UI
src/lib/components
API and access
- Container API
src/routes/api/containers/+server.ts - Stack API
src/routes/api/stacks/+server.ts - Schedule API
src/routes/api/schedules/+server.ts - Environment API
src/routes/api/environments/+server.ts
Docker operations
- Docker operations
src/lib/server/docker.ts - Metrics collector
collector/main.go - Worker manager
src/lib/server/subprocess-manager.ts - Stack management
src/lib/server/stacks.ts - Image scanning
src/lib/server/scanner.ts
Automation and backup
- Scheduled tasks
src/lib/server/scheduler/index.ts - Backup API
src/lib/server/backups/index.ts - Backup execution
src/lib/server/backups/backup-service.ts - Restore execution
src/lib/server/backups/restore-service.ts - Backup models
src/lib/server/backups/models.ts
Persistence and integrations
- Database operations
src/lib/server/db.ts - Database adapter
src/lib/server/db/drizzle.ts - SQLite / PostgreSQL
- Notification services
src/lib/server/notifications/index.ts
Other components
- Operator
- Docker hosts
- Restic
Connections 24
- Operator → Management UI: operates
- Management UI → Container API: manages containers
- Management UI → Stack API: orchestrates stacks
- Management UI → Environment API: selects environments
- Management UI → Schedule API: configures schedules
- Container API → Docker operations: Docker operations
- Stack API → Stack management: manages stacks
- Docker operations → Docker hosts: controls hosts
- Worker manager → Metrics collector: runs worker
src/lib/server/subprocess-manager.ts - Metrics collector → Docker hosts: collects events
- Worker manager → Database operations: records events
src/lib/server/subprocess-manager.ts - Schedule API → Database operations: reads schedules
src/routes/api/schedules/+server.ts - Schedule API → Scheduled tasks: lists system schedules
src/routes/api/schedules/+server.ts - Scheduled tasks → Backup execution: runs backups
- Backup API → Backup execution: starts backup
- Backup API → Restore execution: starts restore
- Backup execution → Backup models: uses result types
src/lib/server/backups/backup-service.ts - Restore execution → Backup models: uses error types
src/lib/server/backups/restore-service.ts - Backup execution → Restic: runs snapshots
- Restore execution → Restic: restores snapshots
- Database operations → Database adapter: uses adapter
src/lib/server/db.ts - Database adapter → SQLite / PostgreSQL: persists records
- Image scanning → Docker hosts: scans images
- Worker manager → Notification services: sends notifications
src/lib/server/subprocess-manager.ts