uVersion
Français
Télécharger →

Wiki

Installer uVersion Server

Choisissez votre voie : Ubuntu / Debian (paquet .deb), Windows (PowerShell) ou Docker.

Le serveur uVersion s'installe en une ligne de commande sur Ubuntu/Debian, sur Windows, ou via Docker. L'installateur pose quelques questions, met en place PostgreSQL, la base, le service système et le certificat HTTPS, puis vous affiche votre mot de passe administrateur. Comptez dix minutes.

Vocabulaire

Six mots reviennent partout dans ces pages. Si l'un vous est étranger, cette section suffit : rien d'autre n'est supposé connu.

  • Dossier de données : le dossier où le serveur écrit tout ce qui vous appartient, à savoir le contenu de vos fichiers versionnés, son certificat et son identité. Vous le choisissez à l'installation. C'est le dossier à sauvegarder.
  • Cluster PostgreSQL : une instance de base de données, avec son propre dossier et son propre port. Une même machine peut en héberger plusieurs sans qu'elles se voient. uVersion utilise celui du système, ou le sien, selon ce que vous répondez.
  • Service système : un programme qui tourne en arrière-plan et redémarre seul au démarrage de la machine. On dit « service Windows » sous Windows, « unit systemd » sous Linux.
  • Empreinte TLS : une suite de 64 caractères qui identifie le certificat du serveur. Vous la confirmez une fois sur chaque poste, comme la première connexion SSH à une machine.
  • Code d'activation : le code UV-XXXX-XXXX-XXXX reçu par email. L'installateur l'échange contre votre licence complète. Il ne sert qu'une seule fois.
  • Purge : la désinstallation complète d'un paquet, réponses de configuration comprises. Sous Debian, apt remove retire le programme, apt purge retire en plus ses réglages.

Prérequis

  • Une machine (VPS, mini-PC, serveur de bureau) sous Ubuntu 24.04+, Debian 13+, ou Windows 10, 11, Server 2019+. Le conteneur Docker couvre les autres distributions.
  • Les droits d'administration sur cette machine : root sous Linux, en pratique via sudo, ou un PowerShell « Exécuter en tant qu'administrateur » sous Windows. L'installateur refuse de démarrer sans.
  • Votre code d'activation uVersion (format UV-XXXX-XXXX-XXXX) reçu par email à l'émission de votre licence, ou récupérable depuis votre espace compte. Ce code est à usage unique : une fois échangé, il ne peut plus servir sur une autre machine.
  • Un accès Internet sortant vers licence.uversion.io (HTTPS), le temps de l'échange du code. Sur un réseau sans accès Internet, voir la section « Installation non interactive et hors ligne » de la page Ubuntu : l'installateur accepte aussi la clé de licence complète, que vous récupérez depuis votre espace compte sur un autre poste.
  • PostgreSQL. Sur Ubuntu et Debian, il arrive automatiquement comme dépendance du paquet, vous n'avez rien à faire. Sous Windows, l'installateur le pose via winget, absent de Windows Server 2019 et 2022 : sur ces deux versions, installez PostgreSQL 16 à la main avant de lancer le script.
  • De l'espace disque. Le serveur lui-même et la base pèsent peu : c'est le magasin de fragments (le contenu de vos fichiers, toutes révisions confondues) qui domine, donc dimensionnez sur la taille de vos projets Unreal et leur historique. Si vous placez aussi la base sur le dossier de données, l'installateur y écrit en plus un fichier de lest de 1 Go, à supprimer en cas de disque plein.
  • Le port TCP 8443 ouvert en entrée, c'est par là que vos postes se connectent. L'installateur Windows crée la règle de pare-feu lui-même. Le paquet Debian n'ouvre aucun port : faites-le vous-même, par exemple sudo ufw allow 8443/tcp.

Choisir votre voie

Ubuntu / Debian

Ubuntu 24.04+, Debian 13+. Installation via paquet .deb.

sudo apt install ./uversion-server_*.deb

Windows

Windows 10, 11, Server 2019+. Une ligne PowerShell en Administrateur.

iwr https://uversion.io/downloads/server/install.ps1 -UseBasicParsing | iex

Docker

Serveur et base en conteneurs. La seule voie supportée sur la famille Red Hat (RHEL, Rocky, AlmaLinux, Fedora).

docker compose up -d

HTTPS et certificat

Le serveur parle HTTPS uniquement, sur le port 8443. Il n'y a rien à configurer et aucun nom de domaine n'est nécessaire : au premier démarrage, le serveur génère lui-même son certificat, dit auto-signé, et affiche son empreinte SHA-256 à la fin de l'installation. Chaque poste confirme cette empreinte une seule fois, à la première connexion, et refuse ensuite toute empreinte différente.

Conséquence visible : un navigateur qui ouvre https://<ip-du-serveur>:8443 affiche un avertissement de sécurité, parce que ce certificat n'est signé par aucune autorité publique. C'est attendu. Vérifiez que l'empreinte affichée est bien celle notée à l'installation, puis passez outre.

L avertissement de securite affiche par le navigateur a la premiere connexion au serveur, avec le bouton permettant de continuer.

Détail de la procédure côté postes : Empreinte TLS. Si votre serveur possède un nom de domaine et que vous disposez déjà d'un certificat, vous pouvez déposer le vôtre à la place : voir la section 2 du runbook d'exploitation (docs/operations.md) livré avec le serveur.

Et après ?

L'installation vous affiche, dans un encadré, l'identifiant admin, un mot de passe temporaire et l'adresse du serveur. Notez-les. Vous vous connectez ensuite depuis n'importe quel poste du réseau, avec un navigateur ou le client desktop, à l'adresse https://<ip-du-serveur>:8443, où <ip-du-serveur> est l'adresse de la machine que vous venez d'installer.

  • Premier login : se connecter avec le mot de passe initial, le changer
  • Empreinte TLS : certificat auto-signé, à confirmer une fois côté client
  • Dépannage : « le service ne démarre pas », « code d'activation rejeté », etc.