Guides

These guides take you from a clean machine to a running, integrated Blue Dots deployment.

Installation

Two separate tracks :

Local Setup — run a DPG on your own machine: Prerequisites, Local Stack (Docker), Signals DPG Setup, Aggregator DPG Setup.
Cloud Setup — deploy a real instance: AWS Infrastructure Setup, AWS Deployment.

Activate a district

Activating Blue Dots in a District — the institutional and operational model.
Adaptor Onboarding — the end-to-end path for a new adaptor.

Configure & extend

Keycloak Setup — realm import, admin user, registering an integrating DPG.
Configuration — env vars, config-as-code, per-environment overrides.
Customisation & Branding — branding, dashboards and a landing page, without forking the DPGs.
AI Voice Agent Prompts — the published prompt DPGs and how a voice channel connects.
API Conventions — auth headers, error codes and response conventions shared by both APIs.

Build & deploy

CI/CD & Build Pipeline — how images are built, pinned and delivered across environments.