Installation — overview
Two install paths — a Python source install (uvicorn on a Linux host) or a Docker Compose stack with optional Portainer and Traefik. Pick one; the rest of the section walks each path step by step.
Installation
Install the Liberty Framework from source: clone liberty-next + liberty-apps, create the Python virtual environment, build the React frontend, bootstrap the auth store and launch the server on port 8000.
Docker
Stand up Liberty Framework as a Docker Compose stack — Liberty, PostgreSQL, optional Traefik. Concrete compose file, env vars, mount points and the first-run bootstrap.
Portainer (optional)
Manage the Liberty Docker stack visually — see container status, tail logs, restart services and edit the compose stack from a browser. Setup, the Liberty stack import, common operator tasks.
Traefik (optional)
Front Liberty Framework with Traefik — reverse proxy, friendly hostname, automatic Let's Encrypt TLS via DNS challenge or HTTP challenge. Full Docker Compose snippet for the Liberty stack.
Running in production
Run the Liberty Framework in production: bare-metal systemd unit, container image with Podman / Docker, Kubernetes Deployment + Service. PostgreSQL pool, reverse proxy with nginx, TLS, log routing, the LIBERTY_APPS_DIR mount and the scheduler-on-one-replica pattern.
Upgrading
How to move a Liberty install from one framework version to the next: stop the service, pull the new code, refresh Python deps, build the frontend, apply database migrations, smoke-test then restart. Compatibility expectations between liberty-next and liberty-apps.