Installare su Windows

Windows 10, 11 o Windows Server 2019+ (x64). Installazione con una sola riga di PowerShell.

Installare

1. Aprire PowerShell come amministratore

Fai clic con il tasto destro sull'icona di PowerShell → Esegui come amministratore. Altrimenti lo script si rifiuta di avviarsi, e te lo dice.

2. Incollare il comando di installazione

Una sola riga, da incollare così com'è nella finestra che hai appena aperto:

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

Lo script procede quindi, sotto i tuoi occhi:

• la richiesta del codice di attivazione, l'unica domanda posta: vedi il passo successivo
• il download del binario e la verifica dell'archivio
• l'installazione di PostgreSQL tramite winget se assente (circa 2 minuti)
• la creazione del database, del ruolo e del servizio Windows, e l'apertura del firewall (8443, più 8080 di riserva)
• la registrazione della voce in Programmi e funzionalità
• l'avvio del servizio, la generazione del certificato TLS autofirmato e poi la visualizzazione della password di amministratore e dell'impronta SHA-256 del certificato

Tutto avviene nella tua finestra di PowerShell, vedi ogni passaggio. È l'equivalente Windows del sudo apt install di Linux.

3. Inserire il codice di attivazione

È l'unica domanda posta: tutte le altre scelte passano da parametri, descritti più in basso. Il campo accetta tre forme: il codice breve UV-XXXX-XXXX-XXXX, un percorso a un file contenente la tua chiave di licenza completa, o quella chiave incollata direttamente. Solo con la prima forma, lo script contatta licence.uversion.io per scambiare il codice con la chiave.

4. Annotare il riepilogo finale

L'installazione termina con un riquadro: nome utente admin, password temporanea, indirizzo del server e impronta del certificato. Annotali.

Se la finestra è stata chiusa troppo in fretta, la password è ancora sul disco finché non è stata cambiata:

Get-Content "C:\ProgramData\uVersion\initial-admin-password"

Questo file scompare non appena cambi la password: un errore "Cannot find path" significa quindi che il cambiamento è già avvenuto.

Puoi poi seguire Primo accesso.

Windows Server 2019 e 2022: prima PostgreSQL

Variante non interattiva (CI, distribuzione tramite script)

& ([scriptblock]::Create((iwr https://uversion.io/downloads/server/install.ps1 -UseBasicParsing).Content)) `
    -LicenceKey "UV-XXXX-XXXX-XXXX" -DataDir "D:\uVersion" -DbOnDataDir

I nove parametri accettati:

Dove vanno i file

Tutto vive nella cartella dati, C:\ProgramData\uVersion per impostazione predefinita: la configurazione (config.toml), il contenuto dei tuoi file versionati (data\chunks), il certificato TLS e la sua impronta (data\tls), e la password di amministratore iniziale.

Dopo ogni modifica manuale di config.toml, riavvia il servizio affinché venga applicata:

Restart-Service uVersionServer

Verificare l'installazione

Quattro controlli indipendenti. Sostituisci C:\ProgramData\uVersion con la tua cartella dati se ne hai scelta un'altra.

1. Il servizio è in esecuzione

Get-Service uVersionServer

Atteso: Status: Running.

2. Il server è in ascolto in HTTPS sulla 8443

Get-NetTCPConnection -LocalPort 8443 -State Listen

Deve comparire una riga. Nulla del tutto mentre il servizio è in esecuzione significa in genere che il TLS è stato disattivato nella configurazione: il server passa allora a HTTP semplice e la 8443 non è più in ascolto.

3. Rivisualizzare l'impronta del certificato

Get-Content "C:\ProgramData\uVersion\data\tls\fingerprint"

È l'impronta che ogni postazione conferma alla sua prima connessione.

4. Rileggere la configurazione attiva

Get-Content "C:\ProgramData\uVersion\config.toml"

Se il servizio si rifiuta di avviarsi, il modo più diretto per vedere perché è avviare il binario in primo piano: gli errori di avvio compaiono allora direttamente nella tua finestra. È del resto il comando che lo script di installazione ti propone lui stesso quando constata il fallimento.

$env:CONFIG_PATH = 'C:\ProgramData\uVersion\config'
& 'C:\Program Files\uVersion\uversion-server.exe'

Ferma poi con Ctrl+C, quindi Start-Service uVersionServer. Se il servizio non si avvia nemmeno abbastanza da produrre un errore, il Visualizzatore eventi di Windows (eventvwr.msc) lo registra nel log Sistema, origine Service Control Manager. Non cercarvi un log applicativo con il nome uVersion: il server scrive sul suo standard output, non registra un'origine di eventi di Windows, quindi un comando del tipo Get-EventLog -Source uVersionServer non restituirà mai nulla.

Disinstallare

Due modi equivalenti. Entrambi eseguono lo stesso script (uninstall.ps1), che gestisce il servizio, il firewall, la variabile d'ambiente della macchina, la cartella dati, il binario, la voce in Programmi e funzionalità e il database PostgreSQL.

Metodo 1: tramite Programmi e funzionalità

1. Win+R → appwiz.cpl → Invio
2. Trova uVersion Server nell'elenco
3. Clic destro → Disinstalla
4. Si apre una finestra di PowerShell da amministratore che esegue lo script in modo visibile

Metodo 2: tramite PowerShell come amministratore

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

Lo script mostra i tuoi due percorsi all'avvio, poi un blocco di verifica alla fine: dovresti vedere "OK absent" in verde per il servizio, la directory di installazione, la cartella dati e la voce in Programmi e funzionalità.

$body = (iwr "https://uversion.io/downloads/server/uninstall.ps1" -UseBasicParsing).Content
if ($body -is [byte[]]) { $body = [Text.Encoding]::UTF8.GetString($body) }
& ([scriptblock]::Create($body)) -InstallDir "D:\uVersion\bin" -DataDir "D:\uVersion"

Disinstallare anche PostgreSQL?

Per impostazione predefinita uninstall.ps1 non tocca PostgreSQL: altre applicazioni potrebbero usarlo. Per rimuoverlo anch'esso:

$body = (iwr "https://uversion.io/downloads/server/uninstall.ps1" -UseBasicParsing).Content
if ($body -is [byte[]]) { $body = [Text.Encoding]::UTF8.GetString($body) }
& ([scriptblock]::Create($body)) -RemovePostgreSQL

Il controllo [byte[]] è necessario: a seconda del tipo di contenuto servito, Invoke-WebRequest -UseBasicParsing può restituire il corpo della risposta come array di byte o come stringa. Lo schema sopra funziona in entrambi i casi.