orun) lets you deploy and manage containers on any VPS or dedicated server using nothing but a Git repository. Commit a manifest, push it, and every node reconciles itself to match — no SSH required after initial setup, no control plane to maintain, no complex CD pipeline to debug.
Quick Start
Bootstrap your first node and deploy a container in minutes.
How It Works
Understand the pull-based reconciliation model and why it works offline.
Configuration Reference
Explore all manifest fields for Nodes, Deployments, and Services.
CLI Reference
Full reference for the
orun bootstrap and orun start commands.Get up and running
Install orun
Download the
orun binary and place it on your PATH. See Quick Start for platform-specific instructions.Create a manifest repository
Initialize a Git repository that will hold your node and deployment manifests. This repository is the single source of truth for your infrastructure.
Bootstrap a node
Run
orun bootstrap from the manifest repository root. orun connects via SSH, installs Docker if needed, copies itself to the node, and starts a systemd service.Why Orcra Run?
No control plane
Nodes operate autonomously. Your cluster keeps running even when your laptop is offline.
Git is the source of truth
Every configuration change is a commit. Roll back by reverting. Audit history for free.
Built-in ingress & SSL
Caddy is embedded in
orun. Point a domain at your node and SSL provisioning is automatic.Encrypted secrets in Git
Commit SOPS-encrypted secrets directly to your manifest repository. Nodes decrypt at apply time using age keys that never leave the node.