How astarte-platform/astarte works
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: router.ex Application API · data_handler.ex Device data updater · AstarteManager.tsx Astarte dashboard · triggers_handler.ex Trigger events
Components 21
Device connectivity
- Pairing and onboarding
apps/astarte_pairing/lib/astarte_pairing/engine.ex - MQTT broker plugin
apps/astarte_vmq_plugin/lib/astarte_vmq_plugin/rpc/server.ex
Platform management
- Realm management API
apps/astarte_realm_management/lib/astarte_realm_management_web/controllers/interface_controller.ex - Realm administration
apps/astarte_housekeeping/lib/astarte_housekeeping_web/controllers/realm_controller.ex - Interfaces and mappings
apps/astarte_core/lib/astarte_core/interface.ex
Data processing
- Persistent data access
apps/astarte_data_access/lib/astarte_data_access/repo.ex - Device data updater
apps/astarte_data_updater_plant/lib/astarte_data_updater_plant/data_updater/core/data_handler.ex - Ingestion pipelines
apps/astarte_data_updater_plant/lib/astarte_data_updater_plant/data_pipeline_supervisor.ex - Trigger events
apps/astarte_events/lib/astarte_events/triggers_handler/triggers_handler.ex - Trigger engine
apps/astarte_trigger_engine/lib/astarte_trigger_engine/application.ex
Application access
- Application API
apps/astarte_appengine_api/lib/astarte_appengine_api_web/router.ex - Device data queries
apps/astarte_appengine_api/lib/astarte_appengine_api/device/queries.ex - Service RPC
apps/astarte_rpc/lib/astarte_rpc/application.ex
Pipeline dashboard
- Astarte dashboard
astarte-dashboard/src/AstarteManager.tsx - Pipeline management
astarte-dashboard/src/PipelinesPage.tsx - Pipeline authoring
astarte-dashboard/src/NewPipelinePage.tsx - Pipeline details
astarte-dashboard/src/PipelineSourcePage.tsx
Other components
- Device fleet
- Remote applications
- Cassandra or ScyllaDB
- RabbitMQ
Connections 19
- 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
astarte-dashboard/src/PipelinesPage.tsx - Astarte dashboard → Pipeline authoring: authors pipelines
astarte-dashboard/src/NewPipelinePage.tsx - Astarte dashboard → Pipeline details: views pipeline source
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