# vitodeploy/vito architecture

> Architecture diagram of the GitHub repository vitodeploy/vito, 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/vitodeploy/vito
- Repository: https://github.com/vitodeploy/vito

## Overview

Vito is a self-hosted server and application deployment control plane. Users manage infrastructure and deploy PHP applications through the web interface or API; deployments then coordinate runtime components on their servers. The tree and README establish distinct provisioning, deployment, operations, and workflow capabilities, but most implementations were not sampled, so those branches are represented at their exact action directories with few asserted connections. The storage-provider path is more directly evidenced: users configure providers, credentials are stored, and provider handlers expose remote storage operations.

Main entry points: [`app/Http/Controllers`](https://github.com/vitodeploy/vito/tree/4.x/app/Http/Controllers) (Web and API), [`app/StorageProviders/AbstractStorageProvider.php`](https://github.com/vitodeploy/vito/blob/4.x/app/StorageProviders/AbstractStorageProvider.php) (Storage Handlers), [`app/Actions/StorageProvider/EditStorageProvider.php`](https://github.com/vitodeploy/vito/blob/4.x/app/Actions/StorageProvider/EditStorageProvider.php) (Provider Management), [`app/Http/Controllers/StorageProviderController.php`](https://github.com/vitodeploy/vito/blob/4.x/app/Http/Controllers/StorageProviderController.php) (Storage Provider UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_control["Control Plane"]
  node_api["Web and API"]
  node_projects[("Projects and Access<br/>[Project.php]")]
  node_storage_ui["Storage Provider UI"]
  node_storage_model[("Provider Records")]
end

subgraph group_deploy["Application Delivery"]
  node_applications[("Applications<br/>[Application.php]")]
  node_environments["Environments"]
  node_components["Runtime Components"]
  node_deployments["Deployment Orchestration"]
  node_sites["Sites and Domains"]
end

subgraph group_infra["Infrastructure Operations"]
  node_servers[("Server Management<br/>[Server.php]")]
  node_provision["Provisioning"]
  node_services["Service Management"]
  node_security["Firewall and SSL"]
  node_network["Private Networks"]
  node_databases["Database Management"]
  node_backups["Backup and Restore"]
end

subgraph group_integrations["Integrations and Automation"]
  node_source["Source Control"]
  node_storage_actions["Provider Management"]
  node_registry["Provider Registry"]
  node_handlers["Storage Handlers"]
  node_storage_contract["Storage Operations<br/>[Storage.php]"]
  node_workflows["Workflows"]
end

node_user(("User"))
node_api_actor(("API Client"))

node_user -->|"manages"| node_api
node_api_actor -->|"uses"| node_api
node_api -.->|"scopes access"| node_projects
node_user -->|"configures"| node_storage_ui
node_storage_ui -->|"invokes"| node_storage_actions
node_storage_actions -->|"saves"| node_storage_model
node_storage_actions -->|"verifies credentials"| node_handlers
node_registry -->|"registers"| node_handlers
node_storage_model -->|"resolves handler"| node_handlers
node_handlers -->|"returns operations"| node_storage_contract
node_api -.->|"manages servers"| node_provision
node_api -.->|"manages apps"| node_applications
node_applications -.->|"has environments"| node_environments
node_environments -.->|"configures runtime"| node_components
node_source -.->|"triggers deploys"| node_deployments
node_deployments -.->|"runs stages"| node_components
node_api -.->|"manages services"| node_services
node_api -.->|"manages security"| node_security
node_api -.->|"manages networks"| node_network
node_api -.->|"manages databases"| node_databases
node_api -.->|"manages backups"| node_backups
node_api -.->|"manages sites"| node_sites
node_api -.->|"runs workflows"| node_workflows

click node_api "https://github.com/vitodeploy/vito/tree/4.x/app/Http/Controllers"
click node_projects "https://github.com/vitodeploy/vito/blob/4.x/app/Models/Project.php"
click node_servers "https://github.com/vitodeploy/vito/blob/4.x/app/Models/Server.php"
click node_provision "https://github.com/vitodeploy/vito/tree/4.x/app/Actions/Server"
click node_services "https://github.com/vitodeploy/vito/tree/4.x/app/Actions/Service"
click node_security "https://github.com/vitodeploy/vito/tree/4.x/app/Actions/FirewallRule"
click node_network "https://github.com/vitodeploy/vito/tree/4.x/app/Actions/Network"
click node_applications "https://github.com/vitodeploy/vito/blob/4.x/app/Models/Application.php"
click node_environments "https://github.com/vitodeploy/vito/tree/4.x/app/Actions/Environment"
click node_components "https://github.com/vitodeploy/vito/tree/4.x/app/Actions/Component"
click node_deployments "https://github.com/vitodeploy/vito/tree/4.x/app/Actions/EnvironmentDeployment"
click node_source "https://github.com/vitodeploy/vito/tree/4.x/app/Actions/SourceControl"
click node_sites "https://github.com/vitodeploy/vito/tree/4.x/app/Actions/Site"
click node_databases "https://github.com/vitodeploy/vito/tree/4.x/app/Actions/Database"
click node_backups "https://github.com/vitodeploy/vito/tree/4.x/app/Actions/Backup"
click node_storage_ui "https://github.com/vitodeploy/vito/blob/4.x/app/Http/Controllers/StorageProviderController.php"
click node_storage_actions "https://github.com/vitodeploy/vito/blob/4.x/app/Actions/StorageProvider/EditStorageProvider.php"
click node_storage_model "https://github.com/vitodeploy/vito/blob/4.x/app/Models/StorageProvider.php"
click node_registry "https://github.com/vitodeploy/vito/blob/4.x/app/Providers/StorageProviderServiceProvider.php"
click node_handlers "https://github.com/vitodeploy/vito/blob/4.x/app/StorageProviders/AbstractStorageProvider.php"
click node_storage_contract "https://github.com/vitodeploy/vito/blob/4.x/app/SSH/Storage/Storage.php"
click node_workflows "https://github.com/vitodeploy/vito/tree/4.x/app/Actions/Workflow"

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_api,node_projects,node_storage_ui,node_storage_model,node_user,node_api_actor toneBlue
class node_applications,node_environments,node_components,node_deployments,node_sites toneAmber
class node_servers,node_provision,node_services,node_security,node_network,node_databases,node_backups toneMint
class node_source,node_storage_actions,node_registry,node_handlers,node_storage_contract,node_workflows toneRose
```

## Components

### Control Plane

- [Web and API](https://github.com/vitodeploy/vito/tree/4.x/app/Http/Controllers): `app/Http/Controllers`
- [Projects and Access](https://github.com/vitodeploy/vito/blob/4.x/app/Models/Project.php): `app/Models/Project.php`
- [Storage Provider UI](https://github.com/vitodeploy/vito/blob/4.x/app/Http/Controllers/StorageProviderController.php): `app/Http/Controllers/StorageProviderController.php`
- [Provider Records](https://github.com/vitodeploy/vito/blob/4.x/app/Models/StorageProvider.php): `app/Models/StorageProvider.php`

### Application Delivery

- [Applications](https://github.com/vitodeploy/vito/blob/4.x/app/Models/Application.php): `app/Models/Application.php`
- [Environments](https://github.com/vitodeploy/vito/tree/4.x/app/Actions/Environment): `app/Actions/Environment`
- [Runtime Components](https://github.com/vitodeploy/vito/tree/4.x/app/Actions/Component): `app/Actions/Component`
- [Deployment Orchestration](https://github.com/vitodeploy/vito/tree/4.x/app/Actions/EnvironmentDeployment): `app/Actions/EnvironmentDeployment`
- [Sites and Domains](https://github.com/vitodeploy/vito/tree/4.x/app/Actions/Site): `app/Actions/Site`

### Infrastructure Operations

- [Server Management](https://github.com/vitodeploy/vito/blob/4.x/app/Models/Server.php): `app/Models/Server.php`
- [Provisioning](https://github.com/vitodeploy/vito/tree/4.x/app/Actions/Server): `app/Actions/Server`
- [Service Management](https://github.com/vitodeploy/vito/tree/4.x/app/Actions/Service): `app/Actions/Service`
- [Firewall and SSL](https://github.com/vitodeploy/vito/tree/4.x/app/Actions/FirewallRule): `app/Actions/FirewallRule`
- [Private Networks](https://github.com/vitodeploy/vito/tree/4.x/app/Actions/Network): `app/Actions/Network`
- [Database Management](https://github.com/vitodeploy/vito/tree/4.x/app/Actions/Database): `app/Actions/Database`
- [Backup and Restore](https://github.com/vitodeploy/vito/tree/4.x/app/Actions/Backup): `app/Actions/Backup`

### Integrations and Automation

- [Source Control](https://github.com/vitodeploy/vito/tree/4.x/app/Actions/SourceControl): `app/Actions/SourceControl`
- [Provider Management](https://github.com/vitodeploy/vito/blob/4.x/app/Actions/StorageProvider/EditStorageProvider.php): `app/Actions/StorageProvider/EditStorageProvider.php`
- [Provider Registry](https://github.com/vitodeploy/vito/blob/4.x/app/Providers/StorageProviderServiceProvider.php): `app/Providers/StorageProviderServiceProvider.php`
- [Storage Handlers](https://github.com/vitodeploy/vito/blob/4.x/app/StorageProviders/AbstractStorageProvider.php): `app/StorageProviders/AbstractStorageProvider.php`
- [Storage Operations](https://github.com/vitodeploy/vito/blob/4.x/app/SSH/Storage/Storage.php): `app/SSH/Storage/Storage.php`
- [Workflows](https://github.com/vitodeploy/vito/tree/4.x/app/Actions/Workflow): `app/Actions/Workflow`

### Other components

- **User**
- **API Client**

## Connections

- User → Web and API: manages (evidence: `README.md`)
- API Client → Web and API: uses (evidence: `README.md`)
- Web and API → Projects and Access: scopes access (evidence: `app/Http/Controllers/API/StorageProviderController.php`)
- User → Storage Provider UI: configures (evidence: `app/Http/Controllers/StorageProviderController.php`)
- Storage Provider UI → Provider Management: invokes (evidence: `app/Http/Controllers/StorageProviderController.php`)
- Provider Management → Provider Records: saves (evidence: `app/Actions/StorageProvider/EditStorageProvider.php`)
- Provider Management → Storage Handlers: verifies credentials (evidence: `app/Actions/StorageProvider/EditStorageProvider.php`)
- Provider Registry → Storage Handlers: registers (evidence: `app/Providers/StorageProviderServiceProvider.php`)
- Provider Records → Storage Handlers: resolves handler (evidence: `app/Models/StorageProvider.php`)
- Storage Handlers → Storage Operations: returns operations
- Web and API → Provisioning: manages servers
- Web and API → Applications: manages apps
- Applications → Environments: has environments
- Environments → Runtime Components: configures runtime
- Source Control → Deployment Orchestration: triggers deploys
- Deployment Orchestration → Runtime Components: runs stages
- Web and API → Service Management: manages services
- Web and API → Firewall and SSL: manages security
- Web and API → Private Networks: manages networks
- Web and API → Database Management: manages databases
- Web and API → Backup and Restore: manages backups
- Web and API → Sites and Domains: manages sites
- Web and API → Workflows: runs workflows
