Wiki

uVersion Server installieren

Wählen Sie Ihren Weg: Ubuntu / Debian (.deb-Paket), Windows (PowerShell) oder Docker.

Der uVersion-Server lässt sich mit einem einzigen Befehl unter Ubuntu/Debian, unter Windows oder über Docker installieren. Der Installer stellt einige Fragen, richtet PostgreSQL, die Datenbank, den Systemdienst und das HTTPS-Zertifikat ein und zeigt Ihnen dann Ihr Administrator-Passwort an. Rechnen Sie mit zehn Minuten.

Begriffe

Sechs Wörter tauchen überall in diesen Seiten auf. Ist Ihnen eines davon fremd, genügt dieser Abschnitt: nichts anderes wird als bekannt vorausgesetzt.

Datenordner: der Ordner, in den der Server alles schreibt, was Ihnen gehört, nämlich den Inhalt Ihrer versionierten Dateien, sein Zertifikat und seine Identität. Sie wählen ihn bei der Installation. Dies ist der Ordner, den es zu sichern gilt.
PostgreSQL-Cluster: eine Datenbankinstanz mit eigenem Ordner und eigenem Port. Ein und dieselbe Maschine kann mehrere davon beherbergen, ohne dass sie sich gegenseitig sehen. uVersion nutzt je nach Ihrer Antwort den des Systems oder seinen eigenen.
Systemdienst: ein Programm, das im Hintergrund läuft und beim Start der Maschine von selbst neu startet. Unter Windows spricht man von einem „Windows-Dienst“, unter Linux von einer „systemd-Unit“.
TLS-Fingerabdruck: eine Folge von 64 Zeichen, die das Zertifikat des Servers identifiziert. Sie bestätigen ihn einmal auf jedem Arbeitsplatz, wie bei der ersten SSH-Verbindung zu einer Maschine.
Aktivierungscode: der per E-Mail erhaltene Code UV-XXXX-XXXX-XXXX. Der Installer tauscht ihn gegen Ihre vollständige Lizenz ein. Er ist nur ein einziges Mal verwendbar.
Purge: die vollständige Deinstallation eines Pakets, einschließlich seiner Konfigurationsantworten. Unter Debian entfernt apt remove das Programm, apt purge entfernt zusätzlich seine Einstellungen.

Voraussetzungen

Eine Maschine (VPS, Mini-PC, Büroserver) unter Ubuntu 24.04+, Debian 13+ oder Windows 10, 11, Server 2019+. Der Docker-Container deckt die übrigen Distributionen ab.
Administrationsrechte auf dieser Maschine: root unter Linux, in der Praxis über sudo, oder ein PowerShell „Als Administrator ausführen“ unter Windows. Der Installer weigert sich, ohne sie zu starten.
Ihr uVersion-Aktivierungscode (Format UV-XXXX-XXXX-XXXX), den Sie bei Ausstellung Ihrer Lizenz per E-Mail erhalten oder in Ihrem Kontobereich abrufen können. Dieser Code ist zur einmaligen Verwendung: einmal eingetauscht, lässt er sich auf keiner anderen Maschine mehr verwenden.
Ausgehender Internetzugang zu licence.uversion.io (HTTPS), für die Dauer des Code-Austauschs. In einem Netz ohne Internetzugang siehe den Abschnitt „Nicht-interaktive und Offline-Installation“ der Ubuntu-Seite: der Installer akzeptiert auch den vollständigen Lizenzschlüssel, den Sie an einem anderen Arbeitsplatz aus Ihrem Kontobereich abrufen.
PostgreSQL. Unter Ubuntu und Debian kommt es automatisch als Abhängigkeit des Pakets, Sie müssen nichts tun. Unter Windows richtet der Installer es über winget ein, das unter Windows Server 2019 und 2022 fehlt: installieren Sie auf diesen beiden Versionen PostgreSQL 16 von Hand, bevor Sie das Skript starten.
Speicherplatz. Der Server selbst und die Datenbank sind klein: es ist der Chunk-Speicher (der Inhalt Ihrer Dateien über alle Revisionen hinweg), der dominiert, dimensionieren Sie also nach der Größe Ihrer Unreal-Projekte und deren Verlauf. Legen Sie auch die Datenbank in den Datenordner, schreibt der Installer dort zusätzlich eine 1-GB-Ballastdatei, die im Fall eines vollen Datenträgers zu löschen ist.
Der eingehend geöffnete TCP-Port 8443, darüber verbinden sich Ihre Arbeitsplätze. Der Windows-Installer erstellt die Firewallregel selbst. Das Debian-Paket öffnet keinen Port: tun Sie es selbst, zum Beispiel sudo ufw allow 8443/tcp.

Weg wählen

Ubuntu / Debian

Ubuntu 24.04+, Debian 13+. Installation über .deb-Paket.


        sudo apt install ./uversion-server_*.deb

Windows

Windows 10, 11, Server 2019+. Eine einzelne PowerShell-Zeile als Administrator.


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

Docker

Server und Datenbank in Containern. Der einzige unterstützte Weg auf der Red-Hat-Familie (RHEL, Rocky, AlmaLinux, Fedora).


        docker compose up -d

HTTPS und Zertifikat

Der Server spricht ausschließlich HTTPS, auf Port 8443. Es gibt nichts zu konfigurieren und kein Domainname ist nötig: beim ersten Start erzeugt der Server sein Zertifikat selbst, ein sogenanntes selbstsigniertes, und zeigt am Ende der Installation seinen SHA-256-Fingerabdruck an. Jeder Arbeitsplatz bestätigt diesen Fingerabdruck ein einziges Mal, bei der ersten Verbindung, und weist danach jeden abweichenden Fingerabdruck zurück.

Sichtbare Folge: ein Browser, der https://<Server-IP>:8443 öffnet, zeigt eine Sicherheitswarnung, weil dieses Zertifikat von keiner öffentlichen Instanz signiert ist. Das ist zu erwarten. Prüfen Sie, dass der angezeigte Fingerabdruck tatsächlich der bei der Installation notierte ist, und fahren Sie dann fort.

Die Sicherheitswarnung, die der Browser bei der ersten Verbindung zum Server anzeigt, mit der Schaltflaeche zum Fortfahren.

Details des Ablaufs auf der Arbeitsplatz-Seite: TLS-Fingerabdruck. Besitzt Ihr Server einen Domainnamen und verfügen Sie bereits über ein Zertifikat, können Sie stattdessen Ihr eigenes hinterlegen: siehe Abschnitt 2 des mit dem Server ausgelieferten Betriebs-Runbooks (docs/operations.md).

Wie geht es weiter?

Die Installation zeigt Ihnen in einem Kasten den Benutzernamen admin, ein temporäres Passwort und die Serveradresse. Notieren Sie sie. Anschließend verbinden Sie sich von jedem beliebigen Arbeitsplatz im Netz aus, mit einem Browser oder dem Desktop-Client, unter der Adresse https://<Server-IP>:8443, wobei <Server-IP> die Adresse der soeben installierten Maschine ist.

Erste Anmeldung : mit dem initialen Passwort anmelden, es ändern
TLS-Fingerabdruck : selbstsigniertes Zertifikat, einmal auf der Clientseite zu bestätigen
Fehlerbehebung : „Dienst startet nicht“, „Aktivierungscode abgelehnt“ usw.