What Cairn is

Cairn turns one Ubuntu server, or a small cluster, into your own place to deploy and run apps.

You install it with one command. You then get a web portal where you create projects, deploy them from Git, add databases, keep secrets, and watch logs, metrics and errors. Everything runs on your own machine.

Start here

  1. Install Cairn on a server.
  2. Create your first project in the portal.
  3. Deploy an app from your Git repository.
curl -fsSL https://github.com/Mpratyush54/SERVER-automation/releases/latest/download/install.sh | bash
sudo platformctl provision

What you get

  • Deploys from Git. Pick a branch and commit, and Cairn deploys the Kubernetes files in your repository with Argo CD. Branches can get their own preview environment. Cairn can also build images from your source code, if you turn builds on.
  • Databases. PostgreSQL, MongoDB and Redis run on the server. Each project gets its own credentials.
  • Secrets. Encrypted settings for each environment, with history and rollback.
  • Monitoring. Logs, metrics, traces, error tracking, uptime checks and alerts, in the portal.
  • Sign-in and roles. Passwords, two-factor sign-in, GitHub or GitLab sign-in, and roles that limit who can do what.
  • Backups. Encrypted backups to S3-compatible storage, and a restore you can test.
  • AI agents. Paste your server's /mcp address into Claude, ChatGPT, Cursor or VS Code and sign in. Assistants get only the access you approve, and risky commands wait for a person.
  • SDKs. Node.js, Python, React and Angular libraries connect your app to logs, metrics and databases.

How it fits together

Cairn runs on k3s, a small Kubernetes distribution. The installer, platformctl, sets up k3s, the databases, Argo CD, the monitoring stack, and the Cairn API and portal. Each project environment gets its own Kubernetes namespace.

              Browser / SDK
                    |
            Ingress (HTTPS)
                    |
   +----------------+----------------+
   |                |                |
Cairn API        Portal           Argo CD
   |
PostgreSQL · MongoDB · Redis · MinIO

For the full picture, see How Cairn works.

Find your way around

You want to Go to
Install on a server Install
Ship your app Deploy an app
Add a database Databases
Protect your data Backups and restore
See what is happening Monitoring and alerts
Run on several servers High availability
Fix a broken install Recover and Troubleshooting
Look up a command CLI