System Design

Technical Architecture

OpenRun

|

04

Developer Push Code + Config
Git Repo Source of Truth
OpenRun Server Reconciler & Router
Docker / Podman / K8s Container Runtime
App Instance Running Service
SYNC
ORCHESTRATE

Auth Layer

Audit Logs

Architecture Flow

Single Binary Orchestration

The core server is a single Go binary that manages the entire lifecycle. It acts as both the controller for reconciliation and the router for incoming requests.

Flexible Runtime Support

Deploys directly to Docker, Podman, or Kubernetes. Single node deployment uses an embedded SQLite database, Kubernetes deployment uses Postgres for metadata.

Git-Based State Reconciliation

Periodically pulls configuration from the specified Git repository, diffs the desired state against the running containers/pods and applies changes.

Built-in Governance Layer

Authentication (OAuth/OIDC/SAML) and auditing are handled at the platform layer, shielding applications from security complexity.