# astarte-platform/astarte architecture

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

- Interactive diagram: https://gitdiagram.com/astarte-platform/astarte
- Repository: https://github.com/astarte-platform/astarte

## Overview

Astarte is a distributed IoT platform for connecting device fleets to remote applications and processing incoming data. The broad workflow is device onboarding and connection, interface/data modeling, data ingestion and storage, then application access and event-driven processing. The repository also includes a dashboard for managing data pipelines. The README establishes the product capabilities; most service-to-service wiring is not shown in the sampled source, so those relationships are omitted or marked unverified rather than presented as inspected calls.

Main entry points: [`apps/astarte_appengine_api/lib/astarte_appengine_api_web/router.ex`](https://github.com/astarte-platform/astarte/blob/master/apps/astarte_appengine_api/lib/astarte_appengine_api_web/router.ex) (Application API), [`apps/astarte_data_updater_plant/lib/astarte_data_updater_plant/data_updater/core/data_handler.ex`](https://github.com/astarte-platform/astarte/blob/master/apps/astarte_data_updater_plant/lib/astarte_data_updater_plant/data_updater/core/data_handler.ex) (Device data updater), [`astarte-dashboard/src/AstarteManager.tsx`](https://github.com/astarte-platform/astarte/blob/master/astarte-dashboard/src/AstarteManager.tsx) (Astarte dashboard), [`apps/astarte_events/lib/astarte_events/triggers_handler/triggers_handler.ex`](https://github.com/astarte-platform/astarte/blob/master/apps/astarte_events/lib/astarte_events/triggers_handler/triggers_handler.ex) (Trigger events)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_device["Device connectivity"]
  node_pairing["Pairing and onboarding<br/>[engine.ex]"]
  node_vmq["MQTT broker plugin<br/>[server.ex]"]
end

subgraph group_management["Platform management"]
  node_realm_api["Realm management API"]
  node_housekeeping["Realm administration"]
  node_core_model["Interfaces and mappings<br/>[interface.ex]"]
end

subgraph group_processing["Data processing"]
  node_data_access["Persistent data access<br/>[repo.ex]"]
  node_updater["Device data updater<br/>[data_handler.ex]"]
  node_pipeline_supervisor["Ingestion pipelines"]
  node_events["Trigger events"]
  node_trigger_engine["Trigger engine<br/>[application.ex]"]
end

subgraph group_access["Application access"]
  node_appengine["Application API<br/>[router.ex]"]
  node_appengine_data["Device data queries<br/>[queries.ex]"]
  node_rpc["Service RPC<br/>[application.ex]"]
end

subgraph group_dashboard["Pipeline dashboard"]
  node_dashboard["Astarte dashboard<br/>[AstarteManager.tsx]"]
  node_pipeline_list["Pipeline management<br/>[PipelinesPage.tsx]"]
  node_pipeline_create["Pipeline authoring"]
  node_pipeline_source["Pipeline details"]
end

node_device_actor(("Device fleet"))
node_remote_apps(("Remote applications"))
node_cassandra[("Cassandra or ScyllaDB")]
node_rabbitmq["RabbitMQ"]

node_device_actor -.->|"onboards with"| node_pairing
node_device_actor -.->|"connects through"| node_vmq
node_vmq -.->|"forwards telemetry"| node_updater
node_updater -.->|"processes data"| node_pipeline_supervisor
node_updater -.->|"stores data"| node_data_access
node_data_access -.->|"persists in"| node_cassandra
node_realm_api -.->|"manages interfaces"| node_core_model
node_remote_apps -.->|"accesses platform"| node_appengine
node_appengine -.->|"queries device data"| node_appengine_data
node_appengine_data -.->|"reads data"| node_data_access
node_updater -.->|"emits events"| node_events
node_events -.->|"dispatches triggers"| node_trigger_engine
node_events -.->|"uses messaging"| node_rabbitmq
node_dashboard -->|"manages pipelines"| node_pipeline_list
node_dashboard -->|"authors pipelines"| node_pipeline_create
node_dashboard -->|"views pipeline source"| node_pipeline_source
node_pipeline_list -.->|"uses client API"| node_appengine
node_pipeline_create -.->|"registers pipeline"| node_appengine
node_pipeline_source -.->|"loads and deletes"| node_appengine

click node_pairing "https://github.com/astarte-platform/astarte/blob/master/apps/astarte_pairing/lib/astarte_pairing/engine.ex"
click node_vmq "https://github.com/astarte-platform/astarte/blob/master/apps/astarte_vmq_plugin/lib/astarte_vmq_plugin/rpc/server.ex"
click node_realm_api "https://github.com/astarte-platform/astarte/blob/master/apps/astarte_realm_management/lib/astarte_realm_management_web/controllers/interface_controller.ex"
click node_housekeeping "https://github.com/astarte-platform/astarte/blob/master/apps/astarte_housekeeping/lib/astarte_housekeeping_web/controllers/realm_controller.ex"
click node_core_model "https://github.com/astarte-platform/astarte/blob/master/apps/astarte_core/lib/astarte_core/interface.ex"
click node_data_access "https://github.com/astarte-platform/astarte/blob/master/apps/astarte_data_access/lib/astarte_data_access/repo.ex"
click node_updater "https://github.com/astarte-platform/astarte/blob/master/apps/astarte_data_updater_plant/lib/astarte_data_updater_plant/data_updater/core/data_handler.ex"
click node_pipeline_supervisor "https://github.com/astarte-platform/astarte/blob/master/apps/astarte_data_updater_plant/lib/astarte_data_updater_plant/data_pipeline_supervisor.ex"
click node_events "https://github.com/astarte-platform/astarte/blob/master/apps/astarte_events/lib/astarte_events/triggers_handler/triggers_handler.ex"
click node_trigger_engine "https://github.com/astarte-platform/astarte/blob/master/apps/astarte_trigger_engine/lib/astarte_trigger_engine/application.ex"
click node_appengine "https://github.com/astarte-platform/astarte/blob/master/apps/astarte_appengine_api/lib/astarte_appengine_api_web/router.ex"
click node_appengine_data "https://github.com/astarte-platform/astarte/blob/master/apps/astarte_appengine_api/lib/astarte_appengine_api/device/queries.ex"
click node_rpc "https://github.com/astarte-platform/astarte/blob/master/apps/astarte_rpc/lib/astarte_rpc/application.ex"
click node_dashboard "https://github.com/astarte-platform/astarte/blob/master/astarte-dashboard/src/AstarteManager.tsx"
click node_pipeline_list "https://github.com/astarte-platform/astarte/blob/master/astarte-dashboard/src/PipelinesPage.tsx"
click node_pipeline_create "https://github.com/astarte-platform/astarte/blob/master/astarte-dashboard/src/NewPipelinePage.tsx"
click node_pipeline_source "https://github.com/astarte-platform/astarte/blob/master/astarte-dashboard/src/PipelineSourcePage.tsx"

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_pairing,node_vmq toneBlue
class node_realm_api,node_housekeeping,node_core_model,node_cassandra toneAmber
class node_data_access,node_updater,node_pipeline_supervisor,node_events,node_trigger_engine toneMint
class node_appengine,node_appengine_data,node_rpc toneRose
class node_dashboard,node_pipeline_list,node_pipeline_create,node_pipeline_source,node_device_actor,node_remote_apps,node_rabbitmq toneIndigo
```

## Components

### Device connectivity

- [Pairing and onboarding](https://github.com/astarte-platform/astarte/blob/master/apps/astarte_pairing/lib/astarte_pairing/engine.ex): `apps/astarte_pairing/lib/astarte_pairing/engine.ex`
- [MQTT broker plugin](https://github.com/astarte-platform/astarte/blob/master/apps/astarte_vmq_plugin/lib/astarte_vmq_plugin/rpc/server.ex): `apps/astarte_vmq_plugin/lib/astarte_vmq_plugin/rpc/server.ex`

### Platform management

- [Realm management API](https://github.com/astarte-platform/astarte/blob/master/apps/astarte_realm_management/lib/astarte_realm_management_web/controllers/interface_controller.ex): `apps/astarte_realm_management/lib/astarte_realm_management_web/controllers/interface_controller.ex`
- [Realm administration](https://github.com/astarte-platform/astarte/blob/master/apps/astarte_housekeeping/lib/astarte_housekeeping_web/controllers/realm_controller.ex): `apps/astarte_housekeeping/lib/astarte_housekeeping_web/controllers/realm_controller.ex`
- [Interfaces and mappings](https://github.com/astarte-platform/astarte/blob/master/apps/astarte_core/lib/astarte_core/interface.ex): `apps/astarte_core/lib/astarte_core/interface.ex`

### Data processing

- [Persistent data access](https://github.com/astarte-platform/astarte/blob/master/apps/astarte_data_access/lib/astarte_data_access/repo.ex): `apps/astarte_data_access/lib/astarte_data_access/repo.ex`
- [Device data updater](https://github.com/astarte-platform/astarte/blob/master/apps/astarte_data_updater_plant/lib/astarte_data_updater_plant/data_updater/core/data_handler.ex): `apps/astarte_data_updater_plant/lib/astarte_data_updater_plant/data_updater/core/data_handler.ex`
- [Ingestion pipelines](https://github.com/astarte-platform/astarte/blob/master/apps/astarte_data_updater_plant/lib/astarte_data_updater_plant/data_pipeline_supervisor.ex): `apps/astarte_data_updater_plant/lib/astarte_data_updater_plant/data_pipeline_supervisor.ex`
- [Trigger events](https://github.com/astarte-platform/astarte/blob/master/apps/astarte_events/lib/astarte_events/triggers_handler/triggers_handler.ex): `apps/astarte_events/lib/astarte_events/triggers_handler/triggers_handler.ex`
- [Trigger engine](https://github.com/astarte-platform/astarte/blob/master/apps/astarte_trigger_engine/lib/astarte_trigger_engine/application.ex): `apps/astarte_trigger_engine/lib/astarte_trigger_engine/application.ex`

### Application access

- [Application API](https://github.com/astarte-platform/astarte/blob/master/apps/astarte_appengine_api/lib/astarte_appengine_api_web/router.ex): `apps/astarte_appengine_api/lib/astarte_appengine_api_web/router.ex`
- [Device data queries](https://github.com/astarte-platform/astarte/blob/master/apps/astarte_appengine_api/lib/astarte_appengine_api/device/queries.ex): `apps/astarte_appengine_api/lib/astarte_appengine_api/device/queries.ex`
- [Service RPC](https://github.com/astarte-platform/astarte/blob/master/apps/astarte_rpc/lib/astarte_rpc/application.ex): `apps/astarte_rpc/lib/astarte_rpc/application.ex`

### Pipeline dashboard

- [Astarte dashboard](https://github.com/astarte-platform/astarte/blob/master/astarte-dashboard/src/AstarteManager.tsx): `astarte-dashboard/src/AstarteManager.tsx`
- [Pipeline management](https://github.com/astarte-platform/astarte/blob/master/astarte-dashboard/src/PipelinesPage.tsx): `astarte-dashboard/src/PipelinesPage.tsx`
- [Pipeline authoring](https://github.com/astarte-platform/astarte/blob/master/astarte-dashboard/src/NewPipelinePage.tsx): `astarte-dashboard/src/NewPipelinePage.tsx`
- [Pipeline details](https://github.com/astarte-platform/astarte/blob/master/astarte-dashboard/src/PipelineSourcePage.tsx): `astarte-dashboard/src/PipelineSourcePage.tsx`

### Other components

- **Device fleet**
- **Remote applications**
- **Cassandra or ScyllaDB**
- **RabbitMQ**

## Connections

- Device fleet → Pairing and onboarding: onboards with
- Device fleet → MQTT broker plugin: connects through
- MQTT broker plugin → Device data updater: forwards telemetry
- Device data updater → Ingestion pipelines: processes data
- Device data updater → Persistent data access: stores data
- Persistent data access → Cassandra or ScyllaDB: persists in
- Realm management API → Interfaces and mappings: manages interfaces
- Remote applications → Application API: accesses platform
- Application API → Device data queries: queries device data
- Device data queries → Persistent data access: reads data
- Device data updater → Trigger events: emits events
- Trigger events → Trigger engine: dispatches triggers
- Trigger events → RabbitMQ: uses messaging
- Astarte dashboard → Pipeline management: manages pipelines (evidence: `astarte-dashboard/src/PipelinesPage.tsx`)
- Astarte dashboard → Pipeline authoring: authors pipelines (evidence: `astarte-dashboard/src/NewPipelinePage.tsx`)
- Astarte dashboard → Pipeline details: views pipeline source (evidence: `astarte-dashboard/src/PipelineSourcePage.tsx`)
- Pipeline management → Application API: uses client API
- Pipeline authoring → Application API: registers pipeline
- Pipeline details → Application API: loads and deletes
