Chapter IV · The host
Ajo Server
A lighthouse of your own.
An Alpine Linux host image with nginx and TLS, rootless Podman and an administration App. Deploy a named version from a Git branch, wait for the host’s receipt, and keep the previous image for rollback.
What Ajo Server gives you
- A reviewed imageAn Alpine host built without network access from a reviewed package lock, with nginx, TLS and rootless Podman.
- An administration AppPasskeys, live host data, typed operations and alerts, itself an Ajo Kit App running on the engine.
- Named versionsEvery arrival is versioned. If a new version does not answer, the host attempts to restore the previous image.
- Deploy from Gitkit deploy builds, seals and ships the App in one step; the branch decides production, staging or a private preview.
- Domains and secretsVerified custom domains and App environment replacement, through typed host operations.
- Backups, stated plainlyLocal App-data archives and an encrypted SQLite coordinator, with what each one does and does not prove.
In practice
Deploy from a named branch
Status Experimental. Hosts come from signed releases, on this machine or on DigitalOcean; there is no automated host replacement yet.
ajo-kit-server0.3.1kit deploy: ship an App to an Ajo Server host.
pnpm add -D ajo-kit-server
pnpm add --save-optional --save-exact ajo-engine@0.2.0 ajo-engine-compiler@0.2.0
pnpm kit host create --provider digitalocean --name apps.example.com
pnpm kit deploy