cairn
Frappe + ERPNext + your custom apps, on a single VPS, running the current commit — automatically.
cairn owns its Docker build recipe and compose configuration outright
(bootstrapped from frappe/frappe_docker) and pairs it with a CI/CD lifecycle you won't find anywhere
else for a Frappe stack:
build, register, and converge a live deployment
- no GitHub Actions
- no webhooks
- no infrastructure to run.
Cairn: a trail marker of stacked stones. Each deploy drops a durable marker (ref → resolved commits → image tag → digest) you can navigate back to.
The magic
Push to a tracked branch. That's the whole workflow:
flowchart TD
A[git push] -. poll .-> B[cairn-build]
B -->|build + push image| C[(registry)]
C -. poll .-> D[cairn-adopt]
D -->|pull + reconcile| E[live ERPNext stack]
Two lightweight systemd timers do the polling — one on the builder, one on the target. Both reach outward; neither GitHub nor anything else ever reaches in. No GitHub Actions runner, no webhook receiver, and no SSH key handed to GitHub for access to your VPS — the box never opens a port for this. A merged commit becomes a rebuilt image, pushed and tagged, and a running stack that pulls it, migrates, and restarts — all within minutes, with zero CI infrastructure to stand up or pay for.
Three roles, one install
Builder — cairn-build |
Registry — cairn-registry |
Target — cairn-adopt |
|
|---|---|---|---|
| Does | Builds the image, pushes it, moves the environment pointer | Hosts images, if you self-host — optional, bring your own registry instead | Polls for the pointer, pulls, and converges the running stack |
One pip install datahenge-cairn installs all three.
📖 Read the docs: datahenge.github.io/cairn
Start with Get Started for installation, or jump straight to the Builder, Target, and Registry walkthroughs.
1 maintainer
Release files for datahenge-cairn 0.4.11
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| datahenge_cairn-0.4.11.tar.gz | 636.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| datahenge_cairn-0.4.11-py3-none-any.whl | Python 3 | none | any | Details |
Total release size:804.0 kB
Release files / datahenge_cairn-0.4.11.tar.gz
| Download URL | datahenge_cairn-0.4.11.tar.gz |
|---|---|
| Size | 636.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
2ab951ba88d07489a9faf15c956cba03fd93de22231db5444c5f044e10c71bff
|
|
BLAKE2b-256 checksum How to use checksums |
93d600995f58a5137d06160bc722c73b7a12ef768c6f3f50a6e5678c41c726b4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.5
|
Release files / datahenge_cairn-0.4.11-py3-none-any.whl
| Download URL | datahenge_cairn-0.4.11-py3-none-any.whl |
|---|---|
| Size | 167.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d3eb1341e7fdeb0f3c3aaaffc0839b20b9abb3dbca9fb4ed1ae5bfc8af8db160
|
|
BLAKE2b-256 checksum How to use checksums |
f5433924a2f0ad2c75d82c1f79044407e017457d466698505f084754324561c7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.5
|
