Instalar no Windows

Windows 10, 11 ou Windows Server 2019+ (x64). Instalação com uma linha de PowerShell.

Instalar

1. Abrir o PowerShell como Administrador

   Clique com o botão direito no ícone do PowerShell → Executar como administrador.

2. Colar o comando

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

   O script:

   • Solicita seu código de ativação (UV-XXXX-XXXX-XXXX)
   • Baixa o binário e verifica o arquivo
   • Instala o PostgreSQL via winget se estiver ausente (~2 min em uma instalação nova)
   • Cria o banco de dados, a função e o serviço do Windows, e abre o firewall (8443 + 8080 de fallback)
   • Registra a entrada em Programas e Recursos
   • Inicia o serviço, gera o certificado TLS autoassinado e exibe a senha de administrador E a impressão digital SHA-256 do certificado

   Tudo acontece na sua janela do PowerShell, você vê cada etapa. É o equivalente no Windows ao sudo apt install do Linux.

3. Anote a senha exibida ao final da instalação (ou recupere-a com Get-Content "C:\ProgramData\uVersion\initial-admin-password").

Em seguida, você pode seguir Primeiro login.

Variante não interativa (CI, implantação com scripts)

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

Todos os parâmetros disponíveis: -LicenceKey, -InstallDir, -DataDir, -Port, -BindAddress, -DownloadUrl, -Reconfigure.

Verificar a instalação

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

Desinstalar

Duas maneiras equivalentes. Ambas executam o mesmo script (uninstall.ps1) que gerencia o serviço, o firewall, a variável de ambiente da máquina, o diretório de dados, o binário, a entrada em Programas e Recursos e o banco de dados PostgreSQL.

1. Via Programas e Recursos

1. Win+R → appwiz.cpl → Enter
2. Encontre uVersion Server na lista
3. Clique com o botão direito → Desinstalar
4. Uma janela do PowerShell de administrador abre e executa o script de forma visível

2. Via PowerShell como Administrador

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

O script mostra um bloco de verificação no final: você deve ver "OK absent" em verde para o serviço, o diretório de instalação, o diretório de dados e a entrada em Programas e Recursos.

Desinstalar o PostgreSQL também?

Por padrão, o uninstall.ps1 não mexe no PostgreSQL (você pode ter outros aplicativos que o usam). Para removê-lo também:

$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

A verificação [byte[]] é necessária: dependendo do Content-Type servido, o Invoke-WebRequest -UseBasicParsing pode retornar o corpo como um array de bytes ou como uma string. O padrão acima funciona nos dois casos.