← Back to docs

Architecture

How the Next.js console, Python core, and provider integrations fit together.

Control plane split

  • The Python FastAPI core owns auth, tenant isolation, provider orchestration, and operational APIs.
  • The Next.js app is the browser-facing console and typed BFF for safe session handling.

Multi-tenant model

  • Admins belong to tenants. Provider resources are mapped to tenants through tenant resource records.
  • API handlers always scope inventory and actions to the authenticated admin tenant.

Provider adapters

  • Coolify powers application inventory and deploy/start/restart actions.
  • Mailcow exposes domain and mailbox visibility.
  • Cloudflare exposes DNS zone and record visibility.