# mistio/mist-ce architecture

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

- Interactive diagram: https://gitdiagram.com/mistio/mist-ce
- Repository: https://github.com/mistio/mist-ce

## Overview

Mist is a multicloud management platform: users manage infrastructure through the web UI or REST API, which can perform cloud operations directly or enqueue asynchronous work. Separate services provide live updates and shell access, while scheduled checks and monitoring feed logs and metrics into their respective stores. The README documents these capabilities and service relationships; the tree exposes only broad application directories, so paths for unsampled subsystems use those directories rather than inferred filenames.

Main entry points: [`api`](https://github.com/mistio/mist-ce/tree/master/api) (REST API), [`ui`](https://github.com/mistio/mist-ce/tree/master/ui) (Mist UI), [`orchestration`](https://github.com/mistio/mist-ce/tree/master/orchestration) (Polling and rules), [`docker/sheller`](https://github.com/mistio/mist-ce/tree/master/docker/sheller) (Sheller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Client interfaces"]
  node_ui["Mist UI"]
  node_rest["REST API"]
  node_ws["WebSocket API"]
end

subgraph group_management["Infrastructure management"]
  node_resources["Resource operations"]
  node_provision["Provisioning"]
  node_lifecycle["Lifecycle actions"]
  node_scripts["Scripts and shells"]
  node_mainstore[("Main database")]
  node_costs["Cost reporting"]
end

subgraph group_runtime["Async and access services"]
  node_workers["Dramatiq workers"]
  node_queue["RabbitMQ"]
  node_scheduler["Scheduler"]
  node_sheller["Sheller"]
end

subgraph group_observability["Monitoring and records"]
  node_polling["Polling and rules"]
  node_metrics["Metric relay"]
  node_timeseries[("Time-series store")]
  node_logstash["Log routing"]
  node_logs[("Log store")]
end

node_user(("User or CLI"))
node_providers{{"Cloud providers"}}

node_user -->|"uses"| node_ui
node_user -->|"calls"| node_rest
node_ui -->|"invokes"| node_rest
node_ui -->|"connects"| node_ws
node_rest -->|"handles"| node_resources
node_rest -->|"operates directly"| node_providers
node_rest -->|"enqueues tasks"| node_queue
node_queue -->|"coordinates work"| node_workers
node_workers -->|"executes tasks"| node_providers
node_resources -.->|"provisions"| node_provision
node_resources -.->|"manages"| node_lifecycle
node_resources -.->|"runs"| node_scripts
node_scheduler -->|"triggers checks"| node_polling
node_scheduler -->|"triggers actions"| node_scripts
node_polling -.->|"relays metrics"| node_metrics
node_metrics -->|"stores metrics"| node_timeseries
node_polling -.->|"records audit events"| node_logs
node_logstash -->|"routes logs"| node_logs
node_ws -->|"proxies shells"| node_sheller
node_sheller -->|"opens connections"| node_providers
node_rest -->|"uses"| node_mainstore
node_rest -.->|"reports costs"| node_costs

click node_ui "https://github.com/mistio/mist-ce/tree/master/ui"
click node_rest "https://github.com/mistio/mist-ce/tree/master/api"
click node_ws "https://github.com/mistio/mist-ce/tree/master/api"
click node_resources "https://github.com/mistio/mist-ce/tree/master/api"
click node_provision "https://github.com/mistio/mist-ce/tree/master/orchestration"
click node_lifecycle "https://github.com/mistio/mist-ce/tree/master/orchestration"
click node_scripts "https://github.com/mistio/mist-ce/tree/master/orchestration"
click node_workers "https://github.com/mistio/mist-ce/tree/master/orchestration"
click node_scheduler "https://github.com/mistio/mist-ce/tree/master/orchestration"
click node_sheller "https://github.com/mistio/mist-ce/tree/master/docker/sheller"
click node_polling "https://github.com/mistio/mist-ce/tree/master/orchestration"
click node_metrics "https://github.com/mistio/mist-ce/tree/master/docker/gocky"
click node_logstash "https://github.com/mistio/mist-ce/tree/master/docker/logstash"
click node_costs "https://github.com/mistio/mist-ce/tree/master/api"

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_ui,node_rest,node_ws,node_user toneBlue
class node_resources,node_provision,node_lifecycle,node_scripts,node_mainstore,node_costs toneAmber
class node_workers,node_queue,node_scheduler,node_sheller toneMint
class node_polling,node_metrics,node_timeseries,node_logstash,node_logs toneRose
class node_providers toneIndigo
```

## Components

### Client interfaces

- [Mist UI](https://github.com/mistio/mist-ce/tree/master/ui): `ui`
- [REST API](https://github.com/mistio/mist-ce/tree/master/api): `api`
- [WebSocket API](https://github.com/mistio/mist-ce/tree/master/api): `api`

### Infrastructure management

- [Resource operations](https://github.com/mistio/mist-ce/tree/master/api): `api`
- [Provisioning](https://github.com/mistio/mist-ce/tree/master/orchestration): `orchestration`
- [Lifecycle actions](https://github.com/mistio/mist-ce/tree/master/orchestration): `orchestration`
- [Scripts and shells](https://github.com/mistio/mist-ce/tree/master/orchestration): `orchestration`
- **Main database**
- [Cost reporting](https://github.com/mistio/mist-ce/tree/master/api): `api`

### Async and access services

- [Dramatiq workers](https://github.com/mistio/mist-ce/tree/master/orchestration): `orchestration`
- **RabbitMQ**
- [Scheduler](https://github.com/mistio/mist-ce/tree/master/orchestration): `orchestration`
- [Sheller](https://github.com/mistio/mist-ce/tree/master/docker/sheller): `docker/sheller`

### Monitoring and records

- [Polling and rules](https://github.com/mistio/mist-ce/tree/master/orchestration): `orchestration`
- [Metric relay](https://github.com/mistio/mist-ce/tree/master/docker/gocky): `docker/gocky`
- **Time-series store**
- [Log routing](https://github.com/mistio/mist-ce/tree/master/docker/logstash): `docker/logstash`
- **Log store**

### Other components

- **User or CLI**
- **Cloud providers**

## Connections

- User or CLI → Mist UI: uses (evidence: `README.md`)
- User or CLI → REST API: calls (evidence: `README.md`)
- Mist UI → REST API: invokes (evidence: `README.md`)
- Mist UI → WebSocket API: connects (evidence: `README.md`)
- REST API → Resource operations: handles (evidence: `README.md`)
- REST API → Cloud providers: operates directly (evidence: `README.md`)
- REST API → RabbitMQ: enqueues tasks (evidence: `README.md`)
- RabbitMQ → Dramatiq workers: coordinates work (evidence: `README.md`)
- Dramatiq workers → Cloud providers: executes tasks (evidence: `README.md`)
- Resource operations → Provisioning: provisions
- Resource operations → Lifecycle actions: manages
- Resource operations → Scripts and shells: runs
- Scheduler → Polling and rules: triggers checks (evidence: `README.md`)
- Scheduler → Scripts and shells: triggers actions (evidence: `README.md`)
- Polling and rules → Metric relay: relays metrics
- Metric relay → Time-series store: stores metrics (evidence: `README.md`)
- Polling and rules → Log store: records audit events
- Log routing → Log store: routes logs (evidence: `README.md`)
- WebSocket API → Sheller: proxies shells (evidence: `README.md`)
- Sheller → Cloud providers: opens connections (evidence: `README.md`)
- REST API → Main database: uses (evidence: `README.md`)
- REST API → Cost reporting: reports costs
