Docker

Docker est le mode d'installation recommandé pour Liberty Next. L'image publique est ghcr.io/fblettner/liberty-next ; le dossier release/ du dépôt contient les fichiers compose et la commande liberty qui les pilote. Rien n'est compilé sur l'hôte.

Le contenu des deux installations est décrit sur Architecture.

Vue d'ensemble

Avant de commencer

Besoin	Détail
Un hôte Linux	Toute distribution qui fait fonctionner Docker Engine. Un poste macOS ou Windows avec Docker Desktop suffit pour un essai.
Docker Engine et le plugin Compose	`docker compose version` doit répondre (Compose v2).
`git` et `curl`	Pour récupérer `release/` et, si besoin, un wheel par URL.
Ports libres	Installation complète : `80` (et `443` pour le HTTPS). Installation légère : `8000`.
Disque	Environ 2 Go libres pour les images ; `./liberty doctor` alerte en dessous de 2 Go.
Mémoire	Le PostgreSQL fourni est réglé avec `shared_buffers = 2GB` : prévoir pour l'installation complète un hôte de plusieurs Go de mémoire.

Récupérer le dossier release/ :

git clone --depth 1 --filter=blob:none --sparse https://github.com/fblettner/liberty-next.git
cd liberty-next && git sparse-checkout set release && cd release

Seul le dossier release/ est récupéré (quelques centaines de Ko, sans l'historique du projet). Un git pull dans ce dossier apporte les scripts de la version suivante — main ne reçoit que les versions publiées ; ajouter --branch v<version> au clone pour en figer une. Ce que l'installation y écrit (.env, apps/, backups/) est ignoré par git : un pull n'y touche jamais. Un hôte qui a cloné tout le projet continue de fonctionner tel quel.

Toutes les commandes de cette page et des suivantes se lancent depuis ce dossier release/.

Installation complète

./liberty install full

La commande :

vérifie Docker et Compose ;
écrit release/.env avec des secrets aléatoires (clé maître, secret JWT, mots de passe de PostgreSQL, de pgAdmin et du tableau de bord Traefik) et la liste des fichiers compose utilisés ;
télécharge les images et démarre les cinq conteneurs ;
attend que liberty-next soit healthy ;
affiche les adresses et les mots de passe.

Fin de la sortie (exemple)
  Liberty:    http://liberty.example.com/
  ReDoc:      http://liberty.example.com/redoc
  pgAdmin:    http://liberty.example.com/pgadmin
  Portainer:  http://liberty.example.com/portainer

  Sign in to Liberty as:
    username:  admin
    password:  Xq7…

  pgAdmin:        admin@liberty.fr / …
  Traefik:        admin / …   (dashboard at …/traefik — shown once; ./liberty dashboard-password regenerates)
  Postgres:       published on 127.0.0.1:5432 only (POSTGRES_BIND=0.0.0.0 in .env to open it)

Noter les mots de passe : celui du tableau de bord Traefik n'est affiché qu'une fois (.env n'en garde que l'empreinte). Ceux de Liberty et de pgAdmin restent dans .env.

Ouvrir l'adresse de Liberty, se connecter en admin, puis poursuivre avec la licence et les applications sous licence et le HTTPS.

Installation légère

./liberty install light

Un conteneur, une base SQLite, le port 8000 : ouvrir http://<hôte>:8000/ et se connecter en admin avec le mot de passe affiché. Pour changer de port : LIBERTY_PORT dans .env, puis ./liberty restart.

L'installation légère n'a pas de Traefik, donc pas de HTTPS propre : sur un réseau partagé, la placer derrière un proxy inverse existant ou choisir l'installation complète.

Options d'installation

./liberty install accepte l'installation et les options suivantes, combinables entre elles.

Option	Effet
`light` / `full`	L'installation. Sans elle, la commande pose la question.
`--tag 7.0.58`	Fixer une version au lieu de `latest` (voir Versions de l'image).
`--apps <wheel ou URL>`	Installer les applications sous licence dès que l'ensemble est démarré — voir Applications sous licence.
`--ssl letsencrypt --domain D --email E`	HTTPS avec un certificat Let's Encrypt (installation complète).
`--ssl provided --domain D --cert-dir DIR --cert-file F --key-file K`	HTTPS avec un certificat fourni (installation complète).
`--db external --db-host H [--db-port 5432] [--db-user liberty] [--db-name liberty] [--db-password-env VAR]`	La base sur un serveur PostgreSQL extérieur à l'ensemble : aucun Postgres intégré n'est démarré. Sans `--db-password-env`, le mot de passe est demandé ; il ne peut pas contenir `$`. Voir Base externe.
`--reset`	Supprime l'ensemble, ses volumes et `.env`, puis s'arrête. Relancer ensuite l'installation.

Une installation de production en une ligne :

./liberty install full --tag 7.0.58 \
  --ssl letsencrypt --domain liberty.example.com --email ops@example.com \
  --apps ./liberty_apps-7.0.58-py3-none-any.whl

La clé de licence n'est pas une option : la coller dans Liberty Next → Administrer → App → License une fois connecté.

Relancer l'installation

Relancer ./liberty install sur un hôte qui a déjà un .env est sans risque : les secrets, les volumes et les fichiers compose enregistrés sont conservés, et l'ensemble est redémarré s'il était arrêté. Pour modifier ensuite le HTTPS ou les applications, utiliser ./liberty ssl … et ./liberty apps … plutôt qu'une nouvelle installation.

Si une installation précédente a laissé des volumes mais que son .env a disparu, l'installation refuse de démarrer : l'ancienne base a été créée avec des mots de passe que plus personne ne connaît. Restaurer l'ancien .env, ou tout effacer avec ./liberty install --reset puis réinstaller.

Versions de l'image

`LIBERTY_IMAGE_TAG` dans `.env`	Signification
`latest` (par défaut)	La version la plus récente. Chaque mise à jour prend la dernière.
`7.0.58`	Cette version, jusqu'à ce qu'une autre soit choisie. Recommandé en production.

La modifier avec ./liberty upgrade --tag <version>, qui prend aussi une sauvegarde et applique les migrations — voir Mise à jour et retour arrière.

Les fichiers compose enregistrés

L'installation écrit dans .env les fichiers compose qui composent l'ensemble — l'installation, puis le fichier HTTPS, puis celui des applications sous licence :

release/.env (extrait)
COMPOSE_FILE=docker-compose.full.yml:docker-compose.tls-letsencrypt.yml:docker-compose.apps.yml

Seules ./liberty ssl … et ./liberty apps … modifient cette ligne ; toutes les autres commandes la reprennent telle quelle. Deux conséquences :

Utiliser ./liberty start, stop, restart, logs, upgrade au quotidien.
Un simple docker compose ps ou docker compose logs sans -f convient (Compose lit la même ligne). Ne jamais passer -f docker-compose.full.yml : Compose ignorerait alors les autres fichiers, recréerait le conteneur sans les applications sous licence ni le HTTPS, et l'installation paraîtrait vide.

Docker Swarm

docker-compose.swarm.yml est l'installation complète adaptée à docker stack deploy : mêmes cinq services, réseau overlay, chaque service placé sur un nœud manager.

docker swarm init                     # une fois, sur le manager
./install.sh prepare                  # écrit seulement .env, ne démarre rien
./deploy-swarm.sh                     # déploie ou met à jour la pile « liberty »
./deploy-swarm.sh --status            # état des services
./deploy-swarm.sh --rm                # supprime la pile (les volumes sont conservés)

docker stack deploy ne lit pas .env : deploy-swarm.sh le charge d'abord dans le shell, et les valeurs sont figées au déploiement. Après une modification de .env, relancer ./deploy-swarm.sh.

Ce qui diffère de Compose :

La commande liberty, --ssl et --apps ne fonctionnent qu'avec les installations Compose. Avec Swarm, les réglages HTTPS ou applications s'ajoutent à la main au fichier de pile.
PostgreSQL doit rester sur un seul nœud pour que son volume le suive : sur un swarm multi-nœuds, ajouter node.hostname == <nœud> à ses contraintes de placement. Traefik doit s'exécuter sur un manager.
Garder une seule réplique de liberty-next : les mises à jour en temps réel sont tenues par le processus, et plusieurs répliques montreraient des états différents aux utilisateurs.
Mettre à jour un service avec docker service update --image ghcr.io/fblettner/liberty-next:<version> liberty_liberty-next, annuler avec docker service rollback liberty_liberty-next.
backup.sh fonctionne de la même façon (les noms de volumes sont identiques) ; restaurer avec la pile supprimée.

Vue d'ensemble​

Avant de commencer​

Installation complète​

Installation légère​

Options d'installation​

Relancer l'installation​

Versions de l'image​

Les fichiers compose enregistrés​

Docker Swarm​