How louislam/dockge works
Dockge is a self-hosted, file-based Docker Compose stack manager. Users browse or edit stacks, perform Compose lifecycle actions, and follow live progress or terminal output; administrators also configure access and connect remote agents. The map preserves the documented image-update, command-to-Compose, and multi-agent capabilities, though their specific implementation paths are not established by the excerpts. Several frontend-to-server relationships are therefore shown as unverified rather than inferred from module names.
Main entry points: router.ts Page routing · dockge-server.ts Dockge server · stack.ts Compose stack · main.ts Vue application
Components 24
Web interface
- Vue application
frontend/src/main.ts - Page routing
frontend/src/router.ts - Stack dashboard
frontend/src/pages/DashboardHome.vue - Compose editor
frontend/src/pages/Compose.vue - Terminal views
frontend/src/components/Terminal.vue - Settings pages
frontend/src/pages/Settings.vue - Socket client
frontend/src/mixins/socket.ts
Server and access
- Dockge server
backend/dockge-server.ts - Main socket actions
backend/socket-handlers/main-socket-handler.ts - Application database
backend/database.ts - Server settings
backend/settings.ts - User accounts
backend/models/user.ts
Stack operations
- Stack socket actions
backend/agent-socket-handlers/docker-socket-handler.ts - Compose stack
backend/stack.ts - Compose utilities
common/util-common.ts - docker run conversion
backend - Image updates
backend
Agents and terminals
- Agent connections
backend/agent-manager.ts - Agent proxy actions
backend/socket-handlers/agent-proxy-socket-handler.ts - Agent Docker actions
backend/agent-socket-handlers/docker-socket-handler.ts - Agent terminal actions
backend/agent-socket-handlers/terminal-socket-handler.ts - Terminal sessions
backend/terminal.ts
Other components
- Operator
- Docker Compose hosts
Connections 27
- Operator → Vue application: uses
README.md - Vue application → Page routing: installs
frontend/src/main.ts - Page routing → Stack dashboard: routes to
frontend/src/router.ts - Page routing → Compose editor: routes to
frontend/src/router.ts - Page routing → Terminal views: routes to
frontend/src/router.ts - Page routing → Settings pages: routes to
frontend/src/router.ts - Vue application → Socket client: mixes in
frontend/src/main.ts - Operator → Stack dashboard: manages stacks
README.md - Operator → Compose editor: edits Compose
README.md - Operator → Terminal views: opens terminal
README.md - Socket client → Dockge server: exchanges events
- Dockge server → Main socket actions: registers actions
backend/dockge-server.ts - Dockge server → Application database: initializes
backend/dockge-server.ts - Main socket actions → User accounts: authenticates
backend/socket-handlers/main-socket-handler.ts - Main socket actions → Server settings: updates
backend/socket-handlers/main-socket-handler.ts - Stack socket actions → Compose stack: invokes lifecycle
backend/agent-socket-handlers/docker-socket-handler.ts - Compose stack → Compose utilities: uses helpers
backend/stack.ts - Stack socket actions → Docker Compose hosts: controls stacks
README.md - Dockge server → Agent connections: manages connections
backend/dockge-server.ts - Agent proxy actions → Agent connections: proxies events
- Agent terminal actions → Terminal sessions: creates sessions
backend/agent-socket-handlers/terminal-socket-handler.ts - Agent Docker actions → Compose stack: dispatches actions
backend/agent-socket-handlers/docker-socket-handler.ts - Agent terminal actions → Docker Compose hosts: opens terminals
- Operator → docker run conversion: converts commands
README.md - Operator → Image updates: updates images
README.md - docker run conversion → Compose stack: produces Compose
backend/agent-socket-handlers/docker-socket-handler.ts - Image updates → Docker Compose hosts: updates images