# serveroshq/panel architecture

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

- Interactive diagram: https://gitdiagram.com/serveroshq/panel
- Repository: https://github.com/serveroshq/panel

## Overview

ServerOS is a web panel for managing Linux servers that remain with their providers. A user connects a machine, then uses the panel to deploy and manage services, monitor health, inspect logs, and run backups or workflows; the panel communicates with each machine’s daemon. Teams and MCP/API integrations provide additional ways to operate the workspace. The README documents the product capabilities; sampled source confirms daemon-job dispatch and workflow execution details, but not every subsystem’s internal wiring.

Main entry points: [`routes/web.php`](https://github.com/serveroshq/panel/blob/main/routes/web.php) (ServerOS panel), [`app/Support/Workflows/WorkflowEngine.php`](https://github.com/serveroshq/panel/blob/main/app/Support/Workflows/WorkflowEngine.php) (Workflow engine), [`app/Models/DaemonJob.php`](https://github.com/serveroshq/panel/blob/main/app/Models/DaemonJob.php) (Daemon jobs), [`app/Models/Workspace.php`](https://github.com/serveroshq/panel/blob/main/app/Models/Workspace.php) (Workspace)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and workspaces"]
  node_panel["ServerOS panel<br/>[web.php]"]
  node_workspace[("Workspace<br/>[Workspace.php]")]
  node_team["Team access"]
end

subgraph group_fleet["Machines and services"]
  node_machines["Machine management"]
  node_machine_state[("Machine records<br/>[Machine.php]")]
  node_daemon["Server daemon"]
  node_gateway["Daemon gateway"]
  node_jobs[("Daemon jobs<br/>[DaemonJob.php]")]
  node_deploy["Service deployment"]
  node_projects[("Projects<br/>[Project.php]")]
end

subgraph group_operations["Operations and workflows"]
  node_backups["Backups<br/>[BackupRunner.php]"]
  node_monitoring["Monitors and status"]
  node_logs["Logs<br/>[LogIngest.php]"]
  node_workflow["Workflow engine<br/>[WorkflowEngine.php]"]
end

subgraph group_interfaces["APIs and assistants"]
  node_api["Public API<br/>[ApiRoutes.php]"]
  node_mcp["MCP tools<br/>[Deploys.php]"]
  node_assistant["AI assistant<br/>[AssistantAgent.php]"]
end

node_user(("User or team"))

node_user -->|"uses"| node_panel
node_panel -->|"operates in"| node_workspace
node_workspace -->|"manages members"| node_team
node_panel -->|"connects and manages"| node_machines
node_machines -->|"tracks"| node_machine_state
node_daemon -->|"connects outward"| node_panel
node_daemon -->|"sends updates"| node_gateway
node_gateway -->|"handles job state"| node_jobs
node_panel -->|"deploys services"| node_deploy
node_deploy -->|"queues work"| node_jobs
node_panel -->|"manages projects"| node_projects
node_panel -->|"runs backups"| node_backups
node_panel -->|"checks uptime"| node_monitoring
node_panel -->|"collects logs"| node_logs
node_panel -->|"runs workflows"| node_workflow
node_workflow -->|"tracks job completion"| node_jobs
node_workflow -->|"runs workflow backups"| node_backups
node_user -->|"integrates tools"| node_api
node_user -->|"uses MCP"| node_mcp
node_assistant -.->|"uses tools"| node_mcp

click node_panel "https://github.com/serveroshq/panel/blob/main/routes/web.php"
click node_workspace "https://github.com/serveroshq/panel/blob/main/app/Models/Workspace.php"
click node_team "https://github.com/serveroshq/panel/blob/main/app/Http/Controllers/WorkspaceMemberController.php"
click node_machines "https://github.com/serveroshq/panel/blob/main/app/Http/Controllers/MachineController.php"
click node_machine_state "https://github.com/serveroshq/panel/blob/main/app/Models/Machine.php"
click node_gateway "https://github.com/serveroshq/panel/blob/main/app/Http/Controllers/Api/DaemonGatewayController.php"
click node_jobs "https://github.com/serveroshq/panel/blob/main/app/Models/DaemonJob.php"
click node_deploy "https://github.com/serveroshq/panel/blob/main/app/Http/Controllers/MachineServiceController.php"
click node_projects "https://github.com/serveroshq/panel/blob/main/app/Models/Project.php"
click node_backups "https://github.com/serveroshq/panel/blob/main/app/Support/Backups/BackupRunner.php"
click node_monitoring "https://github.com/serveroshq/panel/blob/main/app/Http/Controllers/MonitorController.php"
click node_logs "https://github.com/serveroshq/panel/blob/main/app/Support/Logs/LogIngest.php"
click node_workflow "https://github.com/serveroshq/panel/blob/main/app/Support/Workflows/WorkflowEngine.php"
click node_api "https://github.com/serveroshq/panel/blob/main/app/Api/ApiRoutes.php"
click node_mcp "https://github.com/serveroshq/panel/blob/main/app/Mcp/Tools/Deploy/Deploys.php"
click node_assistant "https://github.com/serveroshq/panel/blob/main/app/Support/Assistant/AssistantAgent.php"

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_panel,node_workspace,node_team,node_user toneBlue
class node_machines,node_machine_state,node_daemon,node_gateway,node_jobs,node_deploy,node_projects toneAmber
class node_backups,node_monitoring,node_logs,node_workflow toneMint
class node_api,node_mcp,node_assistant toneRose
```

## Components

### Access and workspaces

- [ServerOS panel](https://github.com/serveroshq/panel/blob/main/routes/web.php): `routes/web.php`
- [Workspace](https://github.com/serveroshq/panel/blob/main/app/Models/Workspace.php): `app/Models/Workspace.php`
- [Team access](https://github.com/serveroshq/panel/blob/main/app/Http/Controllers/WorkspaceMemberController.php): `app/Http/Controllers/WorkspaceMemberController.php`

### Machines and services

- [Machine management](https://github.com/serveroshq/panel/blob/main/app/Http/Controllers/MachineController.php): `app/Http/Controllers/MachineController.php`
- [Machine records](https://github.com/serveroshq/panel/blob/main/app/Models/Machine.php): `app/Models/Machine.php`
- **Server daemon**
- [Daemon gateway](https://github.com/serveroshq/panel/blob/main/app/Http/Controllers/Api/DaemonGatewayController.php): `app/Http/Controllers/Api/DaemonGatewayController.php`
- [Daemon jobs](https://github.com/serveroshq/panel/blob/main/app/Models/DaemonJob.php): `app/Models/DaemonJob.php`
- [Service deployment](https://github.com/serveroshq/panel/blob/main/app/Http/Controllers/MachineServiceController.php): `app/Http/Controllers/MachineServiceController.php`
- [Projects](https://github.com/serveroshq/panel/blob/main/app/Models/Project.php): `app/Models/Project.php`

### Operations and workflows

- [Backups](https://github.com/serveroshq/panel/blob/main/app/Support/Backups/BackupRunner.php): `app/Support/Backups/BackupRunner.php`
- [Monitors and status](https://github.com/serveroshq/panel/blob/main/app/Http/Controllers/MonitorController.php): `app/Http/Controllers/MonitorController.php`
- [Logs](https://github.com/serveroshq/panel/blob/main/app/Support/Logs/LogIngest.php): `app/Support/Logs/LogIngest.php`
- [Workflow engine](https://github.com/serveroshq/panel/blob/main/app/Support/Workflows/WorkflowEngine.php): `app/Support/Workflows/WorkflowEngine.php`

### APIs and assistants

- [Public API](https://github.com/serveroshq/panel/blob/main/app/Api/ApiRoutes.php): `app/Api/ApiRoutes.php`
- [MCP tools](https://github.com/serveroshq/panel/blob/main/app/Mcp/Tools/Deploy/Deploys.php): `app/Mcp/Tools/Deploy/Deploys.php`
- [AI assistant](https://github.com/serveroshq/panel/blob/main/app/Support/Assistant/AssistantAgent.php): `app/Support/Assistant/AssistantAgent.php`

### Other components

- **User or team**

## Connections

- User or team → ServerOS panel: uses (evidence: `README.md`)
- ServerOS panel → Workspace: operates in (evidence: `README.md`)
- Workspace → Team access: manages members (evidence: `README.md`)
- ServerOS panel → Machine management: connects and manages (evidence: `README.md`)
- Machine management → Machine records: tracks
- Server daemon → ServerOS panel: connects outward (evidence: `README.md`)
- Server daemon → Daemon gateway: sends updates (evidence: `README.md`)
- Daemon gateway → Daemon jobs: handles job state (evidence: `app/Http/Controllers/Api/DaemonGatewayController.php`)
- ServerOS panel → Service deployment: deploys services (evidence: `README.md`)
- Service deployment → Daemon jobs: queues work (evidence: `app/Http/Controllers/MachineServiceController.php`)
- ServerOS panel → Projects: manages projects (evidence: `README.md`)
- ServerOS panel → Backups: runs backups (evidence: `README.md`)
- ServerOS panel → Monitors and status: checks uptime (evidence: `README.md`)
- ServerOS panel → Logs: collects logs (evidence: `README.md`)
- ServerOS panel → Workflow engine: runs workflows (evidence: `README.md`)
- Workflow engine → Daemon jobs: tracks job completion (evidence: `app/Support/Workflows/WorkflowEngine.php`)
- Workflow engine → Backups: runs workflow backups (evidence: `app/Support/Workflows/WorkflowEngine.php`)
- User or team → Public API: integrates tools (evidence: `README.md`)
- User or team → MCP tools: uses MCP (evidence: `README.md`)
- AI assistant → MCP tools: uses tools
