ska-octopus-backend
ska-octopus-backend is the FastAPI + GraphQL service that backs the SKAO
Octopus dashboards. It stitches together Tango, local streams, HDB++ PostgreSQL
queries, and external REST/GraphQL APIs while serving a password-protected
configuration UI and widget registry assets.
Note
Memory footprint: each worker loads the full stack (FastAPI, Ariadne, motor, asyncpg, PyTango, etc.), so expect ~350–400 MiB RSS per worker. PyTango remains for environment exploration today; when TangoGQL becomes the only Tango path we’ll drop those heavy deps to slim the baseline. The default entrypoint uses Gunicorn + uvicorn workers; preload/shutdown knobs can help shave memory.
Project info
Version: 0.8.10
Source: https://gitlab.com/ska-telescope/ska-octopus-backend
Changelog: Changelog
Using This Guide
Getting Started shows how to install dependencies and launch a local stack.
Dynamic Endpoint Configuration documents the runtime GraphQL schema loader and security expectations.
API Reference contains the autogenerated API surface with inline commentary.
Changelog tracks release history.
Contents
- Getting Started
- Dynamic Endpoint Configuration
- Deployment Configuration
- Role Levels
- Microsoft Entra ID Setup for Octopus (MSAL Mode)
- Keycloak Setup for Octopus
- 1. Register the Octopus client
- Public client explained
- Multiple deployments
- 2. Create client roles
- 3. Add an audience mapper (recommended for production)
- 4. Assign users
- 5. Backend environment variables
- 6. Frontend configuration (
public/config.js) - 7. How the authentication flow works
- 8. Verification checklist
- 9. Running multiple auth providers simultaneously
- SKAO Octopus Role Assignments
- API Reference
- Changelog
- 0.8.10 - 2026-07-23
- 0.8.9 - 2026-07-20
- 0.8.8 - 2026-07-20
- 0.8.7 - 2026-07-17
- 0.8.6 - 2026-07-17
- 0.8.5 - 2026-07-17
- 0.8.4 - 2026-07-08
- 0.8.2 - 2026-07-07
- 0.8.1 - 2026-07-03
- 0.8.0 - 2026-07-03
- 0.7.6 - 2026-07-02
- 0.7.5 - 2026-07-02
- 0.7.4 - 2026-07-01
- 0.7.3 - 2026-07-01
- 0.7.2 - 2026-06-30
- 0.7.1 - 2026-06-30
- 0.7.0 - 2026-06-16
- 0.6.3 - 2026-05-22
- 0.6.2 - 2026-05-21
- 0.6.1 - 2026-05-19
- 0.6.0 - 2026-05-19
- 0.5.4 - 2026-05-18
- 0.5.3 - 2026-05-13
- 0.5.2 - 2026-05-12
- 0.5.1 - 2026-05-11
- 0.5.0 - 2026-05-11
- 0.4.10 - 2026-05-07
- 0.4.9 - 2026-05-07
- 0.4.8 - 2026-05-06
- 0.4.7 - 2026-05-06
- 0.4.6 - 2026-04-26
- 0.4.5 - 2026-04-25
- 0.4.4 - 2026-04-24
- 0.4.3 - 2026-04-22
- 0.4.2 - 2026-04-20
- 0.4.1 - 2026-04-17
- 0.4.0 - 2026-04-16
- 0.3.2 - 2026-04-16
- 0.3.1 - 2026-04-13
- 0.3.0 - 2026-04-01
- 0.2.3 - 2026-03-26
- 0.2.2 - 2026-03-24
- 0.2.1 - 2026-03-17
- 0.2.0 - 2026-03-16
- 0.1.74 - 2026-03-12
- 0.1.73 - 2026-02-27
- 0.1.72 - 2026-02-23
- 0.1.71 - 2026-02-23
- 0.1.70 - 2026-02-16
- 0.1.69 - 2026-02-16
- 0.1.68 - 2026-02-13
- 0.1.67 - 2026-02-10
- 0.1.66 - 2026-02-02
- 0.1.65 - 2026-01-21
- 0.1.64 - 2026-01-20
- 0.1.63 - 2025-12-10
- 0.1.62 - 2025-12-04
- 0.1.61 - 2025-12-04
- 0.1.60 - 2025-12-03
- 0.1.57 - 2025-12-02
- 0.1.55 - 2025-11-27
- 0.1.54 - 2025-11-26
- 0.1.53 - 2025-11-24
- 0.1.52 - 2025-11-04
- 0.1.51 - 2025-10-20
- 0.1.50 - 2025-10-09
- 0.1.49 - 2025-10-09
- 0.1.48 - 2025-10-06
- 0.1.47 - 2025-10-06
- 0.1.46 - 2025-10-06
- 0.1.45 - 2025-10-01
- 0.1.44 - 2025-09-25
- 0.1.43 - 2025-09-24
- 0.1.42 - 2025-09-18
- 0.1.41 - 2025-09-18
- 0.1.40 - 2025-09-18
- 0.1.39 - 2025-09-16
- 0.1.38 - 2025-09-16
- 0.1.37 - 2025-09-09
- 0.1.36 - 2025-09-05
- 0.1.35 - 2025-09-03
- 0.1.34 - 2025-09-03
- 0.1.33 - 2025-09-03
- 0.1.31 - 2025-08-21
- 0.1.30 - 2025-08-20
- 0.1.29 - 2025-08-19
- 0.1.28 - 2025-08-19
- 0.1.27 - 2025-08-19
- 0.1.26 - 2025-08-19
- 0.1.25 - 2025-08-18
- 0.1.24 - 2025-08-13
- 0.1.23 - 2025-08-08
- 0.1.22 - 2025-08-08
- 0.1.21 - 2025-08-07
- 0.1.20 - 2025-08-07
- 0.1.18 - 2025-08-05
- 0.1.17 - 2025-08-05
- 0.1.16 - 2025-08-05
- 0.1.15 - 2025-08-04
- 0.1.14 - 2025-07-30
- 0.1.13 - 2025-07-28
- 0.1.12 - 2025-07-28
- 0.1.11 - 2025-07-28
- 0.1.10 - 2025-07-24
- 0.1.9 - 2025-07-22
- 0.1.8 - 2025-07-21
- 0.1.6 - 2025-07-21
- 0.1.5 - 2025-07-21
- 0.1.3 - 2025-07-17
- 0.1.0 - 2025-07-11