Wiki

Installer sur Ubuntu / Debian

Paquet .deb avec debconf : code d'activation, PostgreSQL, service systemd, TLS auto-signé.

Ubuntu 24.04+, Debian 13+ (x86_64). 3 étapes.

Installer

Télécharger le paquet
```
cd /tmp && wget -N https://uversion.io/downloads/server/uversion-server_latest_amd64.deb
```
L'URL _latest_ pointe toujours vers la dernière version publiée. Le flag -N dit à wget de ne re-télécharger que si le fichier distant est plus récent : utile pour mettre à jour sans accumuler des copies .deb.1, .deb.2, etc. cd /tmp évite un warning apt cosmétique ("unsandboxed as root") quand le .deb est dans votre home dir.
Installer
```
sudo apt install ./uversion-server_latest_amd64.deb
```
L'installateur vous demande :

Champ Défaut Obligatoire

Code d'activation · Oui

Dossier de données /var/lib/uversion Modifiable

Le postinst contacte licence.uversion.io pour échanger le code contre votre clé de licence complète et l'écrire dans /etc/uversion/config.toml. Un certificat TLS auto-signé est généré au premier démarrage; son empreinte SHA-256 est affichée à la fin de l'install. Voir Empreinte TLS.
Fini. Le code admin initial est affiché en fin d'install dans un encadré coloré. Si vous l'avez raté :
```
sudo cat /var/lib/uversion/initial-admin-password
```

Le récapitulatif affiché en fin d'installation : identifiant admin, mot de passe temporaire et adresse du serveur.

Vous pouvez ensuite suivre Premier login.

Vérifier l'installation

systemctl status uversion-server              # active (running)
ss -tlnp | grep 8443                          # le service ecoute en HTTPS sur 8443
sudo cat /var/lib/uversion/data/tls/fingerprint  # empreinte TLS (a re-afficher)
sudo journalctl -u uversion-server -n 50      # logs recents

Désinstaller

Attention : les commandes ci-dessous suppriment vos repositories, historique, comptes utilisateurs et configurations. Faites un backup PostgreSQL (pg_dump uversion) et copiez /var/lib/uversion/ si vous voulez pouvoir restaurer.

Le paquet apt purge supprime le binaire, l'unit systemd, les réponses debconf, et (via le script postrm) /etc/uversion/ ainsi que l'utilisateur système uversion. Seuls la base PostgreSQL et le data dir /var/lib/uversion/ (créés par le script postinst) sont volontairement préservés et doivent être nettoyés à la main.

Procédure complète :

# 1. Arrêter le service
sudo systemctl stop uversion-server 2>/dev/null
sudo systemctl disable uversion-server 2>/dev/null

# 2. Purge du paquet
sudo apt purge -y uversion-server

# 3. Forcer debconf à oublier les réponses du paquet
echo PURGE | sudo debconf-communicate uversion-server 2>/dev/null || true

# 4. Base PostgreSQL + role
sudo -u postgres psql -c "DROP DATABASE IF EXISTS uversion;"
sudo -u postgres psql -c "DROP ROLE IF EXISTS uversion;"

# 5. Data dir (chunks + initial-admin-password)
sudo rm -rf /var/lib/uversion

# 6. User système (normalement déjà retiré par 'apt purge' via postrm ; sans effet si absent)
sudo deluser --remove-home uversion 2>/dev/null || sudo userdel uversion 2>/dev/null

Vérification :

systemctl status uversion-server                                # "not-found" ou "inactive"
ls /etc/uversion /var/lib/uversion 2>&1                         # "No such file"
which uversion-server                                           # (vide)
sudo -u postgres psql -tAc "SELECT 1 FROM pg_database WHERE datname='uversion';"   # (vide)
sudo -u postgres psql -tAc "SELECT 1 FROM pg_roles WHERE rolname='uversion';"      # (vide)
id uversion                                                     # "no such user"

Champ	Défaut	Obligatoire
Code d'activation	·	Oui
Dossier de données	`/var/lib/uversion`	Modifiable