uVersion
Français
Télécharger →

Wiki

Dépannage

Solutions aux problèmes courants : service bloqué, code d'activation rejeté, PostgreSQL, TLS.

Le service ne démarre pas

Linux : systemctl start échoue 
sudo journalctl -u uversion-server -n 100 --no-pager

Causes fréquentes :

  • PostgreSQL inactif : sudo systemctl status postgresql
  • Mot de passe DB perdu : le postinst regénère la conf avec --reconfigure (sudo dpkg-reconfigure uversion-server)
  • Port 8443 occupé : voir section dédiée plus bas
Windows : erreur 1053 ou 1067

Le service démarre puis s'arrête. Vérifiez l'Event Viewer :

Get-EventLog -LogName Application -Source uVersionServer -Newest 50

Causes fréquentes :

  • Variable d'environnement CONFIG_PATH manquante : normalement définie par l'installateur dans HKLM\SYSTEM\CurrentControlSet\Services\uVersionServer\Environment
  • PostgreSQL inactif : Get-Service postgresql*

Le code d'activation est rejeté

  • Vérifiez que le code n'a pas été utilisé sur une autre machine (chaque code est lié au server-ID de la première install). Demandez un nouveau code depuis votre espace compte.
  • Vérifiez la connectivité vers licence.uversion.io : curl -I https://licence.uversion.io/api/v1/health
  • Si vous voulez réutiliser un code sur une nouvelle machine après désinstallation, contactez le support pour libérer le server-ID précédent.

PostgreSQL inaccessible

Le service uVersion n'arrive pas à se connecter à la base. Tester manuellement :

# Linux
sudo -u postgres psql -c "SELECT 1;"

# Windows
& "C:\Program Files\PostgreSQL\16\bin\psql.exe" -U postgres -h 127.0.0.1 -c "SELECT 1;"

Si PostgreSQL est installé mais le mot de passe du super-utilisateur est perdu, l'installateur uVersion (Linux postinst comme Windows install.ps1) sait remettre PostgreSQL en mode trust automatiquement, réinitialiser le mot de passe, puis restaurer la conf d'origine. Re-lancez :

# Linux
sudo dpkg-reconfigure uversion-server

# Windows
iwr https://uversion.io/downloads/server/install.ps1 -UseBasicParsing | iex
# (re-passe par le script avec -Reconfigure)

Port 8443 déjà utilisé

uVersion écoute par défaut en HTTPS sur 8443 (et garde 8080 ouvert en fallback HTTP). Si l'un des deux est pris :

# Linux
sudo ss -tlnp | grep -E '8443|8080'

# Windows
Get-NetTCPConnection -LocalPort 8443 | Select-Object OwningProcess, State
Get-Process -Id <PID>

Pour changer le port TLS, éditez config.toml :

[tls]
https_port = 9443

Puis redémarrez le service.

Client refuse la connexion TLS

uVersion utilise un certificat auto-signé verrouillé via TOFU côté client (voir Empreinte TLS). Causes les plus fréquentes :

  • Première connexion non-confirmée : le client desktop affiche une boîte de dialogue avec l'empreinte. Compare-la avec ce que l'admin t'a partagé. Côté CLI, lance uversion trust <url>.
  • Empreinte changée (warning rouge) : le serveur a été réinstallé et a regénéré son cert. Confirme out-of-band avec l'admin, puis :
    • Desktop : clique Trust new fingerprint dans le dialogue rouge
    • CLI : uversion mistrust <url> puis uversion login <url>
  • Le serveur ne sert pas HTTPS : vérifie qu'il écoute bien sur 8443, pas 8080 : 
    # Linux
ss -tlnp | grep 8443
# Windows
Get-NetTCPConnection -LocalPort 8443 -State Listen
    Si rien n'écoute, vérifie que [tls] disabled = false dans config.toml (c'est le défaut).
  • Empreinte à re-afficher côté serveur : 
    # Linux
sudo cat /var/lib/uversion/data/tls/fingerprint
# Windows
Get-Content "C:\ProgramData\uVersion\data\tls\fingerprint"

Reset complet

Voir les pages Ubuntu/Debian désinstaller ou Windows désinstaller pour repartir sur une install propre.