Platform v2
Client SDK DB Studio Sign In
Docs / Architecture Overview
Production Cluster

Platform Architecture — OQENS Cloud Docs

Comprehensive reference for the OQENS multi-tenant cloud OS, dual-node compute cluster, and DBaaS engine.

OQENS is a multi-tenant Cloud Operating System and Database Cloud Studio (DBaaS) built for high-performance developer workflows, isolated database provisioning, live system telemetry, and attached object storage.

Compute Nodes & Topology

The production infrastructure runs across an active dual-node compute topology with automated SSL termination and load balancing:

Node Role Services Local Engine
VM1 (Primary) Nginx Ingress Gateway & Master Node nginx, dashboard.service (Port 5000) PostgreSQL 14 Cluster (Port 5432)
VM2 (Secondary) Worker Node & Cloud OS Runtime nginx, cos.service (5000), dashboard.service (5001) Custom Origin Storage Worker
High-Availability Load Balancing
Upstream proxying balances requests equally across VM1 (127.0.0.1:5000) and VM2 (10.0.0.143:80 → 5001) using least_conn with tuned worker connections.

Subdomain Routing Map

Domain Function Authentication Mode
echo.oqens.me Landing portal, user authentication & plan selection Public / Session Cookie
dash.echo.oqens.me Tenant workspace and storage console oqens_session cookie
db.echo.oqens.me Database Cloud Studio SPA Tenant session / Project API key
sdk.echo.oqens.me Universal Client SDK & Multi-Language Gateway Public / Unauthenticated
docs.echo.oqens.me Platform & REST API v2 Master Documentation Public / Unauthenticated
status.echo.oqens.me Incident status and uptime timeline Public / Static Cache

Technology Stack

  • Database Engine: PostgreSQL 14 (Dedicated isolated project databases + connection pooling).
  • Application Gateway: Python Flask + Gunicorn (gevent-websocket worker model).
  • Ingress: Nginx reverse proxy with TLS 1.3 (Let's Encrypt automated certificates).
  • SDK: @oqens/db published on npm registry (Zero runtime dependencies).

Machine-Readable Context

AI coding assistants can ingest the full production platform documentation in raw format:

Copied