Installare su Windows

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

Installare

1. Aprire PowerShell come amministratore

   Fai clic con il tasto destro sull'icona di PowerShell → Esegui come amministratore.

2. Incollare il comando

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

   Lo script:

   • Richiede il tuo codice di attivazione (UV-XXXX-XXXX-XXXX)
   • Scarica il binario e verifica l'archivio
   • Installa PostgreSQL tramite winget se assente (~2 min su un'installazione pulita)
   • Crea il database, il ruolo e il servizio Windows e apre il firewall (8443 + 8080 di riserva)
   • Registra la voce in Programmi e funzionalità
   • Avvia il servizio, genera il certificato TLS autofirmato e mostra la password di amministratore E l'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. Annota la password mostrata al termine dell'installazione (oppure recuperala con Get-Content "C:\ProgramData\uVersion\initial-admin-password").

Puoi poi seguire Primo accesso.

Variante non interattiva (CI, distribuzione tramite script)

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

Tutti i parametri disponibili: -LicenceKey, -InstallDir, -DataDir, -Port, -BindAddress, -DownloadUrl, -Reconfigure.

Verificare l'installazione

Get-Service uVersionServer                                          # Status: Running
Get-NetTCPConnection -LocalPort 8443 -State Listen                  # HTTPS auto-signe
Get-Content "C:\ProgramData\uVersion\data\tls\fingerprint"        # empreinte TLS
Get-EventLog -LogName Application -Source uVersionServer -Newest 20 # logs recents

Disinstallare

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

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

2. Tramite PowerShell come amministratore

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

Lo script mostra un blocco di verifica alla fine: dovresti vedere "OK absent" in verde per il servizio, la directory di installazione, la directory dei dati e la voce in Programmi e funzionalità.

Disinstallare anche PostgreSQL?

Per impostazione predefinita uninstall.ps1 non tocca PostgreSQL (potresti avere altre applicazioni che lo usano). 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 Content-Type servito, Invoke-WebRequest -UseBasicParsing può restituire il corpo come array di byte o come stringa. Lo schema sopra funziona in entrambi i casi.