# coollabsio/coolify architecture

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

- Interactive diagram: https://gitdiagram.com/coollabsio/coolify
- Repository: https://github.com/coollabsio/coolify

## Overview

Coolify is a self-hosted deployment and infrastructure-management platform. Users manage servers and resources through the dashboard, API, CLI, or MCP; application deployment, database/service operation, networking, and ongoing monitoring are distinct product stages. The graph highlights the application/resource models and storage layer alongside those capabilities. Relationships are limited to README-documented capabilities and source-index references; unsampled implementation details are not inferred.

Main entry points: [`app/Livewire`](https://github.com/coollabsio/coolify/tree/main/app/Livewire) (Dashboard), [`app/Livewire/Project/Service/Storage.php`](https://github.com/coollabsio/coolify/blob/main/app/Livewire/Project/Service/Storage.php) (Storage management), [`app/Models/Service.php`](https://github.com/coollabsio/coolify/blob/main/app/Models/Service.php) (Services), [`app/Models/Application.php`](https://github.com/coollabsio/coolify/blob/main/app/Models/Application.php) (Applications)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["User Interfaces"]
  node_dashboard["Dashboard"]
  node_api["Platform API"]
  node_mcp["MCP tools"]
end

subgraph group_deploy["Application Deployment"]
  node_application["Applications<br/>[Application.php]"]
  node_deploy_jobs["Deployment jobs"]
  node_webhooks["Git webhooks"]
  node_previews["Preview deployments"]
end

subgraph group_resources["Databases and Services"]
  node_database_ops["Database operations"]
  node_service["Services<br/>[Service.php]"]
  node_service_app["Service applications"]
  node_service_db["Service databases"]
  node_clickhouse["ClickHouse resource"]
  node_dragonfly["Dragonfly resource"]
end

subgraph group_infra["Server and Networking"]
  node_server["Managed servers<br/>[Server.php]"]
  node_proxy["Proxy and domains"]
end

subgraph group_state["Configuration and Storage"]
  node_storage_ui["Storage management<br/>[Storage.php]"]
  node_file_storage["File volumes"]
  node_persistent_storage["Persistent volumes"]
  node_s3_storage["External storage<br/>[S3Storage.php]"]
  node_environment["Environment variables"]
  node_validation["Validation patterns"]
end

node_users(("Teams and users"))

node_users -->|"manage resources"| node_dashboard
node_users -->|"manage resources"| node_api
node_users -->|"manage resources"| node_mcp
node_dashboard -->|"configure apps"| node_application
node_api -->|"manage apps"| node_application
node_webhooks -->|"trigger deployments"| node_deploy_jobs
node_application -->|"deploy application"| node_deploy_jobs
node_deploy_jobs -->|"deploy to servers"| node_server
node_webhooks -->|"create previews"| node_previews
node_dashboard -->|"operate databases"| node_database_ops
node_dashboard -->|"manage services"| node_service
node_service -.->|"contains resource type"| node_service_app
node_service -.->|"contains resource type"| node_service_db
node_dashboard -->|"configure networking"| node_proxy
node_dashboard -->|"operate infrastructure"| node_server
node_storage_ui -->|"manage mounts"| node_file_storage
node_storage_ui -->|"manage volumes"| node_persistent_storage
node_storage_ui -->|"manage backups"| node_s3_storage
node_storage_ui -->|"validate storage"| node_validation
node_service_app -.->|"uses variables"| node_environment
node_clickhouse -.->|"uses volumes"| node_persistent_storage
node_dragonfly -.->|"uses volumes"| node_persistent_storage

click node_dashboard "https://github.com/coollabsio/coolify/tree/main/app/Livewire"
click node_api "https://github.com/coollabsio/coolify/tree/main/app/Http/Controllers/Api"
click node_mcp "https://github.com/coollabsio/coolify/tree/main/app/Mcp/Tools"
click node_application "https://github.com/coollabsio/coolify/blob/main/app/Models/Application.php"
click node_deploy_jobs "https://github.com/coollabsio/coolify/blob/main/app/Jobs/ApplicationDeploymentJob.php"
click node_webhooks "https://github.com/coollabsio/coolify/tree/main/app/Http/Controllers/Webhook"
click node_previews "https://github.com/coollabsio/coolify/blob/main/app/Http/Controllers/Api/ApplicationPreviewsController.php"
click node_server "https://github.com/coollabsio/coolify/blob/main/app/Models/Server.php"
click node_proxy "https://github.com/coollabsio/coolify/tree/main/app/Actions/Proxy"
click node_database_ops "https://github.com/coollabsio/coolify/tree/main/app/Actions/Database"
click node_service "https://github.com/coollabsio/coolify/blob/main/app/Models/Service.php"
click node_service_app "https://github.com/coollabsio/coolify/blob/main/app/Models/ServiceApplication.php"
click node_service_db "https://github.com/coollabsio/coolify/blob/main/app/Models/ServiceDatabase.php"
click node_clickhouse "https://github.com/coollabsio/coolify/blob/main/app/Models/StandaloneClickhouse.php"
click node_dragonfly "https://github.com/coollabsio/coolify/blob/main/app/Models/StandaloneDragonfly.php"
click node_storage_ui "https://github.com/coollabsio/coolify/blob/main/app/Livewire/Project/Service/Storage.php"
click node_file_storage "https://github.com/coollabsio/coolify/blob/main/app/Models/LocalFileVolume.php"
click node_persistent_storage "https://github.com/coollabsio/coolify/blob/main/app/Models/LocalPersistentVolume.php"
click node_s3_storage "https://github.com/coollabsio/coolify/blob/main/app/Models/S3Storage.php"
click node_environment "https://github.com/coollabsio/coolify/blob/main/app/Models/EnvironmentVariable.php"
click node_validation "https://github.com/coollabsio/coolify/blob/main/app/Support/ValidationPatterns.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_dashboard,node_api,node_mcp,node_users toneBlue
class node_application,node_deploy_jobs,node_webhooks,node_previews toneAmber
class node_database_ops,node_service,node_service_app,node_service_db,node_clickhouse,node_dragonfly toneMint
class node_server,node_proxy toneRose
class node_storage_ui,node_file_storage,node_persistent_storage,node_s3_storage,node_environment,node_validation toneIndigo
```

## Components

### User Interfaces

- [Dashboard](https://github.com/coollabsio/coolify/tree/main/app/Livewire): `app/Livewire`
- [Platform API](https://github.com/coollabsio/coolify/tree/main/app/Http/Controllers/Api): `app/Http/Controllers/Api`
- [MCP tools](https://github.com/coollabsio/coolify/tree/main/app/Mcp/Tools): `app/Mcp/Tools`

### Application Deployment

- [Applications](https://github.com/coollabsio/coolify/blob/main/app/Models/Application.php): `app/Models/Application.php`
- [Deployment jobs](https://github.com/coollabsio/coolify/blob/main/app/Jobs/ApplicationDeploymentJob.php): `app/Jobs/ApplicationDeploymentJob.php`
- [Git webhooks](https://github.com/coollabsio/coolify/tree/main/app/Http/Controllers/Webhook): `app/Http/Controllers/Webhook`
- [Preview deployments](https://github.com/coollabsio/coolify/blob/main/app/Http/Controllers/Api/ApplicationPreviewsController.php): `app/Http/Controllers/Api/ApplicationPreviewsController.php`

### Databases and Services

- [Database operations](https://github.com/coollabsio/coolify/tree/main/app/Actions/Database): `app/Actions/Database`
- [Services](https://github.com/coollabsio/coolify/blob/main/app/Models/Service.php): `app/Models/Service.php`
- [Service applications](https://github.com/coollabsio/coolify/blob/main/app/Models/ServiceApplication.php): `app/Models/ServiceApplication.php`
- [Service databases](https://github.com/coollabsio/coolify/blob/main/app/Models/ServiceDatabase.php): `app/Models/ServiceDatabase.php`
- [ClickHouse resource](https://github.com/coollabsio/coolify/blob/main/app/Models/StandaloneClickhouse.php): `app/Models/StandaloneClickhouse.php`
- [Dragonfly resource](https://github.com/coollabsio/coolify/blob/main/app/Models/StandaloneDragonfly.php): `app/Models/StandaloneDragonfly.php`

### Server and Networking

- [Managed servers](https://github.com/coollabsio/coolify/blob/main/app/Models/Server.php): `app/Models/Server.php`
- [Proxy and domains](https://github.com/coollabsio/coolify/tree/main/app/Actions/Proxy): `app/Actions/Proxy`

### Configuration and Storage

- [Storage management](https://github.com/coollabsio/coolify/blob/main/app/Livewire/Project/Service/Storage.php): `app/Livewire/Project/Service/Storage.php`
- [File volumes](https://github.com/coollabsio/coolify/blob/main/app/Models/LocalFileVolume.php): `app/Models/LocalFileVolume.php`
- [Persistent volumes](https://github.com/coollabsio/coolify/blob/main/app/Models/LocalPersistentVolume.php): `app/Models/LocalPersistentVolume.php`
- [External storage](https://github.com/coollabsio/coolify/blob/main/app/Models/S3Storage.php): `app/Models/S3Storage.php`
- [Environment variables](https://github.com/coollabsio/coolify/blob/main/app/Models/EnvironmentVariable.php): `app/Models/EnvironmentVariable.php`
- [Validation patterns](https://github.com/coollabsio/coolify/blob/main/app/Support/ValidationPatterns.php): `app/Support/ValidationPatterns.php`

### Other components

- **Teams and users**

## Connections

- Teams and users → Dashboard: manage resources (evidence: `README.md`)
- Teams and users → Platform API: manage resources (evidence: `README.md`)
- Teams and users → MCP tools: manage resources (evidence: `README.md`)
- Dashboard → Applications: configure apps (evidence: `README.md`)
- Platform API → Applications: manage apps (evidence: `app/Http/Controllers/Api/ApplicationPreviewsController.php`)
- Git webhooks → Deployment jobs: trigger deployments (evidence: `README.md`)
- Applications → Deployment jobs: deploy application (evidence: `README.md`)
- Deployment jobs → Managed servers: deploy to servers (evidence: `README.md`)
- Git webhooks → Preview deployments: create previews (evidence: `README.md`)
- Dashboard → Database operations: operate databases (evidence: `README.md`)
- Dashboard → Services: manage services (evidence: `README.md`)
- Services → Service applications: contains resource type (evidence: `app/Models/Service.php`)
- Services → Service databases: contains resource type (evidence: `app/Models/Service.php`)
- Dashboard → Proxy and domains: configure networking (evidence: `README.md`)
- Dashboard → Managed servers: operate infrastructure (evidence: `README.md`)
- Storage management → File volumes: manage mounts (evidence: `app/Livewire/Project/Service/Storage.php`)
- Storage management → Persistent volumes: manage volumes (evidence: `app/Livewire/Project/Service/Storage.php`)
- Storage management → External storage: manage backups (evidence: `app/Livewire/Project/Service/Storage.php`)
- Storage management → Validation patterns: validate storage (evidence: `app/Livewire/Project/Service/Storage.php`)
- Service applications → Environment variables: uses variables (evidence: `app/Models/ServiceApplication.php`)
- ClickHouse resource → Persistent volumes: uses volumes (evidence: `app/Models/StandaloneClickhouse.php`)
- Dragonfly resource → Persistent volumes: uses volumes (evidence: `app/Models/StandaloneDragonfly.php`)
