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
- Install Cairn on a server.
- Create your first project in the portal.
- 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
/mcpaddress 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 |