CI Agent

A single-binary CI/CD agent for offline / air-gapped Ubuntu servers that build and deploy Docker Compose stacks behind a manually-managed host nginx.

What it does

  1. Receives a webhook with a git URL (or a ZIP file URL), fetches the sources, and runs a deployment — or deploys a prebuilt image / pasted compose with no source at all.
  2. Builds every build: service in the project’s docker-compose.yml, tagging images per run so old versions stay redeployable.
  3. Optionally runs your tests (ci-test service) before deploying.
  4. Deploys with docker compose up -d, health-gates the result, and automatically rolls back to the last good version on failure.
  5. Manages each project’s nginx server block and TLS — multiple domains with a primary domain that the others 301-redirect to, per-domain HTTPS, and certificates from an internal CA, self-signed, uploaded, or Let’s Encrypt.
  6. Serves this admin UI: running jobs, deployment history, live run and container logs, redeploy, Docker cleanup tools, server resource gauges, and manual runs from a git URL or an uploaded ZIP.

Design at a glance

Property Choice
Footprint one ~6 MB fully-static binary, embedded SQLite, no external services
Pipeline convention over configuration: the compose file is the pipeline
Concurrency serial per project, capped across projects
Offline works with no internet: each deploy tries to pull newer images and quietly uses the local ones when it can’t; no CDN, no telemetry
Proxy plain host nginx; the UI generates each project’s server block and can apply it in one click (or shows the commands to run yourself)
Distribution signed apt repository (apt-get upgrade keeps it current) or a .deb/binary you transfer by hand; built automatically from every commit
Updates apt, the Maintenance page’s built-in self-update, or scp — your choice

Where to go next

New here? Start with Installation, then take the UI tour.