uVersion
Italiano
Scarica →

Wiki

Installare uVersion Server

Scegli il tuo percorso: Ubuntu / Debian (pacchetto .deb), Windows (PowerShell) o Docker.

Il server uVersion si installa con un solo comando su Ubuntu/Debian, su Windows o tramite Docker. L'installer pone alcune domande, predispone PostgreSQL, il database, il servizio di sistema e il certificato HTTPS, poi ti mostra la tua password di amministratore. Conta dieci minuti.

Glossario

Sei parole ricorrono ovunque in queste pagine. Se una ti è estranea, questa sezione basta: nient'altro è dato per noto.

  • Cartella dei dati: la cartella in cui il server scrive tutto ciò che ti appartiene, ovvero il contenuto dei tuoi file versionati, il suo certificato e la sua identità. La scegli in fase di installazione. È la cartella di cui fare il backup.
  • Cluster PostgreSQL: un'istanza di database, con la propria cartella e la propria porta. Una stessa macchina può ospitarne diversi senza che si vedano tra loro. uVersion usa quello del sistema, o il proprio, a seconda di ciò che rispondi.
  • Servizio di sistema: un programma che gira in background e si riavvia da solo all'avvio della macchina. Si chiama «servizio di Windows» su Windows e «unità systemd» su Linux.
  • Impronta TLS: una stringa di 64 caratteri che identifica il certificato del server. La confermi una volta su ogni postazione, come la prima connessione SSH a una macchina.
  • Codice di attivazione: il codice UV-XXXX-XXXX-XXXX ricevuto via email. L'installer lo scambia con la tua licenza completa. Serve una sola volta.
  • Purga: la disinstallazione completa di un pacchetto, comprese le sue risposte di configurazione. Su Debian, apt remove rimuove il programma, apt purge rimuove in più le sue impostazioni.

Prerequisiti

  • Una macchina (VPS, mini-PC, server d'ufficio) con Ubuntu 24.04+, Debian 13+, o Windows 10, 11, Server 2019+. Il contenitore Docker copre le altre distribuzioni.
  • I diritti di amministrazione su quella macchina: root su Linux, in pratica tramite sudo, oppure un PowerShell «Esegui come amministratore» su Windows. L'installer si rifiuta di avviarsi senza.
  • Il tuo codice di attivazione uVersion (formato UV-XXXX-XXXX-XXXX) ricevuto via email all'emissione della licenza, oppure recuperabile dalla tua area account. Questo codice è a uso unico: una volta scambiato, non può più servire su un'altra macchina.
  • Un accesso a Internet in uscita verso licence.uversion.io (HTTPS), per il tempo dello scambio del codice. Su una rete senza accesso a Internet, vedi la sezione «Installazione non interattiva e offline» della pagina Ubuntu: l'installer accetta anche la chiave di licenza completa, che recuperi dalla tua area account su un'altra postazione.
  • PostgreSQL. Su Ubuntu e Debian arriva automaticamente come dipendenza del pacchetto, non devi fare nulla. Su Windows, l'installer lo installa tramite winget, assente da Windows Server 2019 e 2022: su queste due versioni, installa PostgreSQL 16 a mano prima di lanciare lo script.
  • Spazio su disco. Il server in sé e il database pesano poco: è il magazzino dei frammenti (il contenuto dei tuoi file, tutte le revisioni insieme) a dominare, quindi dimensiona in base alla dimensione dei tuoi progetti Unreal e alla loro cronologia. Se collochi anche il database sulla cartella dei dati, l'installer vi scrive in più un file di zavorra da 1 GB, da eliminare in caso di disco pieno.
  • La porta TCP 8443 aperta in entrata, è da lì che si collegano le tue postazioni. L'installer di Windows crea da sé la regola del firewall. Il pacchetto Debian non apre alcuna porta: fallo tu stesso, per esempio sudo ufw allow 8443/tcp.

Scegli il tuo percorso

Ubuntu / Debian

Ubuntu 24.04+, Debian 13+. Installazione tramite pacchetto .deb.

sudo apt install ./uversion-server_*.deb

Windows

Windows 10, 11, Server 2019+. Una singola riga PowerShell come Amministratore.

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

Docker

Server e database in contenitori. L'unico percorso supportato sulla famiglia Red Hat (RHEL, Rocky, AlmaLinux, Fedora).

docker compose up -d

HTTPS e certificato

Il server parla solo HTTPS, sulla porta 8443. Non c'è nulla da configurare e non serve alcun nome di dominio: al primo avvio, il server genera da sé il proprio certificato, detto autofirmato, e mostra la sua impronta SHA-256 al termine dell'installazione. Ogni postazione conferma questa impronta una sola volta, alla prima connessione, e in seguito rifiuta qualsiasi impronta diversa.

Conseguenza visibile: un browser che apre https://<ip-del-server>:8443 mostra un avviso di sicurezza, perché questo certificato non è firmato da alcuna autorità pubblica. È previsto. Verifica che l'impronta mostrata sia effettivamente quella annotata all'installazione, poi prosegui.

L'avviso di sicurezza mostrato dal browser alla prima connessione al server, con il pulsante che permette di continuare.

Dettaglio della procedura lato postazioni: Impronta TLS. Se il tuo server ha un nome di dominio e disponi già di un certificato, puoi inserire il tuo al suo posto: vedi la sezione 2 del runbook operativo (docs/operations.md) fornito con il server.

E poi?

L'installazione ti mostra, in un riquadro, l'utente admin, una password temporanea e l'indirizzo del server. Annotali. Poi ti colleghi da qualsiasi postazione della rete, con un browser o il client desktop, all'indirizzo https://<ip-del-server>:8443, dove <ip-del-server> è l'indirizzo della macchina che hai appena installato.