# ovexro/dockpanel architecture

> Architecture diagram of the GitHub repository ovexro/dockpanel, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ovexro/dockpanel
- Repository: https://github.com/ovexro/dockpanel

## Overview

DockPanel is a self-hosted Linux server-management panel: users manage hosting and operations through a React interface, whose API is served by a Rust backend; the backend can delegate machine-level work to a per-server Rust agent. The sampled database route demonstrates backend-to-agent delegation, while README capabilities establish broader hosting, deployment, backup, security, and monitoring branches. Several route families are represented by their existing directories because their implementations were not sampled; unverified UI/backend links are dashed.

Main entry points: [`panel/backend/src/routes/mod.rs`](https://github.com/ovexro/dockpanel/blob/main/panel/backend/src/routes/mod.rs) (API routes), [`panel/frontend/src/main.tsx`](https://github.com/ovexro/dockpanel/blob/main/panel/frontend/src/main.tsx) (Web application), [`panel/backend/src/main.rs`](https://github.com/ovexro/dockpanel/blob/main/panel/backend/src/main.rs) (Panel API), [`panel/agent/src/services/database_backup.rs`](https://github.com/ovexro/dockpanel/blob/main/panel/agent/src/services/database_backup.rs) (Database backups)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Panel interface"]
  node_frontend["Web application<br/>[main.tsx]"]
  node_authui["Session context<br/>[AuthContext.tsx]"]
  node_api["HTTP client<br/>[api.ts]"]
  node_cli["Developer CLI<br/>[main.rs]"]
  node_mcp["MCP tools<br/>[main.rs]"]
end

subgraph group_control["Control plane"]
  node_backend["Panel API<br/>[main.rs]"]
  node_auth["Authentication<br/>[auth.rs]"]
  node_routes["API routes<br/>[mod.rs]"]
  node_agentbridge["Agent registry<br/>[agent.rs]"]
end

subgraph group_hosting["Hosting operations"]
  node_databaseapi["Database API<br/>[databases.rs]"]
  node_hostingui["Hosting features"]
  node_deploy["Git deployment<br/>[git_deploys.rs]"]
  node_apps["Docker applications<br/>[docker_apps.rs]"]
end

subgraph group_operations["Server operations"]
  node_backups["Backup management"]
  node_monitoring["Monitoring and alerts<br/>[alert_engine.rs]"]
  node_security["Security features<br/>[security.rs]"]
end

subgraph group_agent["Server agent"]
  node_agent["Server agent<br/>[main.rs]"]
  node_agentroutes["Agent routes"]
  node_agentdbbackup["Database backups<br/>[database_backup.rs]"]
  node_agentbackups["Backup service<br/>[backups.rs]"]
  node_safecmd["Safe commands<br/>[safe_cmd.rs]"]
end

node_operator(("Panel user"))

node_operator -->|"uses"| node_frontend
node_frontend -->|"provides session"| node_authui
node_authui -->|"calls"| node_api
node_frontend -->|"routes pages"| node_hostingui
node_hostingui -.->|"requests data"| node_api
node_api -.->|"sends HTTP"| node_backend
node_backend -->|"registers"| node_routes
node_routes -->|"authenticates"| node_auth
node_routes -->|"dispatches"| node_databaseapi
node_databaseapi -->|"requests agent work"| node_agentbridge
node_agentbridge -.->|"communicates"| node_agent
node_agent -.->|"serves operations"| node_agentroutes
node_agentroutes -->|"invokes"| node_agentdbbackup
node_agentdbbackup -->|"uses backup helpers"| node_agentbackups
node_agentdbbackup -->|"runs commands"| node_safecmd
node_routes -.->|"dispatches"| node_deploy
node_routes -.->|"dispatches"| node_apps
node_routes -.->|"dispatches"| node_backups
node_backend -.->|"runs alert engine"| node_monitoring
node_routes -.->|"dispatches"| node_security
node_operator -->|"operates via"| node_cli
node_operator -.->|"uses tools"| node_mcp

click node_frontend "https://github.com/ovexro/dockpanel/blob/main/panel/frontend/src/main.tsx"
click node_authui "https://github.com/ovexro/dockpanel/blob/main/panel/frontend/src/context/AuthContext.tsx"
click node_api "https://github.com/ovexro/dockpanel/blob/main/panel/frontend/src/api.ts"
click node_backend "https://github.com/ovexro/dockpanel/blob/main/panel/backend/src/main.rs"
click node_auth "https://github.com/ovexro/dockpanel/blob/main/panel/backend/src/auth.rs"
click node_routes "https://github.com/ovexro/dockpanel/blob/main/panel/backend/src/routes/mod.rs"
click node_agentbridge "https://github.com/ovexro/dockpanel/blob/main/panel/backend/src/services/agent.rs"
click node_databaseapi "https://github.com/ovexro/dockpanel/blob/main/panel/backend/src/routes/databases.rs"
click node_hostingui "https://github.com/ovexro/dockpanel/tree/main/panel/frontend/src/pages"
click node_deploy "https://github.com/ovexro/dockpanel/blob/main/panel/backend/src/routes/git_deploys.rs"
click node_apps "https://github.com/ovexro/dockpanel/blob/main/panel/backend/src/routes/docker_apps.rs"
click node_backups "https://github.com/ovexro/dockpanel/blob/main/panel/backend/src/routes/backup_orchestrator.rs"
click node_monitoring "https://github.com/ovexro/dockpanel/blob/main/panel/backend/src/services/alert_engine.rs"
click node_security "https://github.com/ovexro/dockpanel/blob/main/panel/backend/src/routes/security.rs"
click node_agent "https://github.com/ovexro/dockpanel/blob/main/panel/agent/src/main.rs"
click node_agentroutes "https://github.com/ovexro/dockpanel/tree/main/panel/agent/src/routes"
click node_agentdbbackup "https://github.com/ovexro/dockpanel/blob/main/panel/agent/src/services/database_backup.rs"
click node_agentbackups "https://github.com/ovexro/dockpanel/blob/main/panel/agent/src/services/backups.rs"
click node_safecmd "https://github.com/ovexro/dockpanel/blob/main/panel/agent/src/safe_cmd.rs"
click node_cli "https://github.com/ovexro/dockpanel/blob/main/panel/cli/src/main.rs"
click node_mcp "https://github.com/ovexro/dockpanel/blob/main/panel/mcp/src/main.rs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_frontend,node_authui,node_api,node_cli,node_mcp,node_operator toneBlue
class node_backend,node_auth,node_routes,node_agentbridge toneAmber
class node_databaseapi,node_hostingui,node_deploy,node_apps toneMint
class node_backups,node_monitoring,node_security toneRose
class node_agent,node_agentroutes,node_agentdbbackup,node_agentbackups,node_safecmd toneIndigo
```

## Components

### Panel interface

- [Web application](https://github.com/ovexro/dockpanel/blob/main/panel/frontend/src/main.tsx): `panel/frontend/src/main.tsx`
- [Session context](https://github.com/ovexro/dockpanel/blob/main/panel/frontend/src/context/AuthContext.tsx): `panel/frontend/src/context/AuthContext.tsx`
- [HTTP client](https://github.com/ovexro/dockpanel/blob/main/panel/frontend/src/api.ts): `panel/frontend/src/api.ts`
- [Developer CLI](https://github.com/ovexro/dockpanel/blob/main/panel/cli/src/main.rs): `panel/cli/src/main.rs`
- [MCP tools](https://github.com/ovexro/dockpanel/blob/main/panel/mcp/src/main.rs): `panel/mcp/src/main.rs`

### Control plane

- [Panel API](https://github.com/ovexro/dockpanel/blob/main/panel/backend/src/main.rs): `panel/backend/src/main.rs`
- [Authentication](https://github.com/ovexro/dockpanel/blob/main/panel/backend/src/auth.rs): `panel/backend/src/auth.rs`
- [API routes](https://github.com/ovexro/dockpanel/blob/main/panel/backend/src/routes/mod.rs): `panel/backend/src/routes/mod.rs`
- [Agent registry](https://github.com/ovexro/dockpanel/blob/main/panel/backend/src/services/agent.rs): `panel/backend/src/services/agent.rs`

### Hosting operations

- [Database API](https://github.com/ovexro/dockpanel/blob/main/panel/backend/src/routes/databases.rs): `panel/backend/src/routes/databases.rs`
- [Hosting features](https://github.com/ovexro/dockpanel/tree/main/panel/frontend/src/pages): `panel/frontend/src/pages`
- [Git deployment](https://github.com/ovexro/dockpanel/blob/main/panel/backend/src/routes/git_deploys.rs): `panel/backend/src/routes/git_deploys.rs`
- [Docker applications](https://github.com/ovexro/dockpanel/blob/main/panel/backend/src/routes/docker_apps.rs): `panel/backend/src/routes/docker_apps.rs`

### Server operations

- [Backup management](https://github.com/ovexro/dockpanel/blob/main/panel/backend/src/routes/backup_orchestrator.rs): `panel/backend/src/routes/backup_orchestrator.rs`
- [Monitoring and alerts](https://github.com/ovexro/dockpanel/blob/main/panel/backend/src/services/alert_engine.rs): `panel/backend/src/services/alert_engine.rs`
- [Security features](https://github.com/ovexro/dockpanel/blob/main/panel/backend/src/routes/security.rs): `panel/backend/src/routes/security.rs`

### Server agent

- [Server agent](https://github.com/ovexro/dockpanel/blob/main/panel/agent/src/main.rs): `panel/agent/src/main.rs`
- [Agent routes](https://github.com/ovexro/dockpanel/tree/main/panel/agent/src/routes): `panel/agent/src/routes`
- [Database backups](https://github.com/ovexro/dockpanel/blob/main/panel/agent/src/services/database_backup.rs): `panel/agent/src/services/database_backup.rs`
- [Backup service](https://github.com/ovexro/dockpanel/blob/main/panel/agent/src/services/backups.rs): `panel/agent/src/services/backups.rs`
- [Safe commands](https://github.com/ovexro/dockpanel/blob/main/panel/agent/src/safe_cmd.rs): `panel/agent/src/safe_cmd.rs`

### Other components

- **Panel user**

## Connections

- Panel user → Web application: uses (evidence: `README.md`)
- Web application → Session context: provides session (evidence: `panel/frontend/src/main.tsx`)
- Session context → HTTP client: calls (evidence: `panel/frontend/src/context/AuthContext.tsx`)
- Web application → Hosting features: routes pages (evidence: `panel/frontend/src/main.tsx`)
- Hosting features → HTTP client: requests data (evidence: `panel/frontend/src/pages/Apps.tsx`)
- HTTP client → Panel API: sends HTTP
- Panel API → API routes: registers (evidence: `panel/backend/src/main.rs`)
- API routes → Authentication: authenticates (evidence: `panel/backend/src/routes/mod.rs`)
- API routes → Database API: dispatches (evidence: `panel/backend/src/routes/mod.rs`)
- Database API → Agent registry: requests agent work (evidence: `panel/backend/src/routes/databases.rs`)
- Agent registry → Server agent: communicates
- Server agent → Agent routes: serves operations (evidence: `panel/agent/src/main.rs`)
- Agent routes → Database backups: invokes (evidence: `panel/agent/src/routes/database_backup.rs`)
- Database backups → Backup service: uses backup helpers (evidence: `panel/agent/src/services/database_backup.rs`)
- Database backups → Safe commands: runs commands (evidence: `panel/agent/src/services/database_backup.rs`)
- API routes → Git deployment: dispatches (evidence: `panel/backend/src/routes/mod.rs`)
- API routes → Docker applications: dispatches (evidence: `panel/backend/src/routes/mod.rs`)
- API routes → Backup management: dispatches (evidence: `panel/backend/src/routes/mod.rs`)
- Panel API → Monitoring and alerts: runs alert engine
- API routes → Security features: dispatches (evidence: `panel/backend/src/routes/mod.rs`)
- Panel user → Developer CLI: operates via (evidence: `README.md`)
- Panel user → MCP tools: uses tools
