Installation — overview
Stand up Liberty Next from the release/ directory — three Docker layouts (light SQLite, full 5-service stack, Docker Swarm), TLS overlays (Let's Encrypt or operator-provided certs), licensed-apps overlay — all driven by ./install.sh, ./install-apps.sh, ./deploy-swarm.sh and ./backup.sh. Plus a pipx alternative for hosts that don't run Docker. Image lives at ghcr.io/fblettner/liberty-next.
Python server
pipx install of Liberty Next on a Linux / macOS host — one PyPI wheel (frontend bundle baked in), four CLIs on the PATH, plus the licensed-apps wheel injected into the same venv when applicable. Bootstrap with liberty-admin init-db + liberty-admin run-install-jobs. No Docker, no git clone, no npm build.
Docker
Stand up Liberty Next as a Docker Compose stack — three layouts (light SQLite, full 5-service production, Swarm) + two TLS overlays + an apps overlay, all wired by ./install.sh and the COMPOSE_FILE chain in .env. ./install-apps.sh adds the licensed apps. ./deploy-swarm.sh drives Swarm. ./backup.sh snapshots every named volume + the apps bind mount.
Bundled visual tools
How to use the Portainer and pgAdmin instances that ship with the Liberty Full Docker layout — first-run setup, common operator tasks, Docker socket security trade-offs, Swarm specifics.
Traefik
The Traefik reverse proxy is bundled in the Full Docker and Swarm layouts. Two TLS modes ship as additive compose overlays — docker-compose.tls-letsencrypt.yml (ACME TLS-ALPN challenge) and docker-compose.tls-provided.yml (operator-provided certs). Both are wired by install.sh --ssl <mode> with no manual compose edits.
Running in production
Production hardening of the Full Docker / Swarm layouts — TLS, password rotation, OIDC, backups, Postgres tuning.
Deploy prebuilt apps
Stand up the NOMANA-IT product apps on a Liberty install — NomaUBL (separate Java service), Nomasx-1 / Nomajde / Nomaflow bundled jobs (delivered as one liberty-apps wheel). The wheel is materialised by install-apps.sh via a throwaway python:3.12-slim container — no host Python or pip needed — then bind-mounted into liberty-next via the docker-compose.apps.yml overlay.
Upgrading
Upgrade a Liberty install — backup, pull the new image, up -d. Image tag pinning, Swarm rolling updates, rollback.