uVersion
Português
Baixar →

Wiki

Instalar o uVersion Server

Escolha seu caminho: Ubuntu / Debian (pacote .deb), Windows (PowerShell) ou Docker.

O servidor uVersion é instalado com um único comando no Ubuntu/Debian, no Windows ou via Docker. O instalador faz algumas perguntas, configura o PostgreSQL, o banco de dados, o serviço do sistema e o certificado HTTPS e, em seguida, exibe sua senha de administrador. Reserve dez minutos.

Vocabulário

Seis palavras se repetem por todas estas páginas. Se alguma lhe for estranha, esta seção basta: nada mais é pressuposto conhecido.

  • Pasta de dados: a pasta onde o servidor grava tudo o que pertence a você, ou seja, o conteúdo dos seus arquivos versionados, o seu certificado e a sua identidade. Você a escolhe na instalação. É a pasta que você deve incluir no backup.
  • Cluster PostgreSQL: uma instância de banco de dados, com sua própria pasta e sua própria porta. Uma mesma máquina pode hospedar vários sem que se vejam entre si. O uVersion usa o do sistema, ou o seu próprio, conforme o que você responder.
  • Serviço do sistema: um programa que roda em segundo plano e reinicia sozinho ao ligar a máquina. Chama-se «serviço do Windows» no Windows e «unidade systemd» no Linux.
  • Impressão digital TLS: uma sequência de 64 caracteres que identifica o certificado do servidor. Você a confirma uma vez em cada estação, como a primeira conexão SSH a uma máquina.
  • Código de ativação: o código UV-XXXX-XXXX-XXXX recebido por e-mail. O instalador o troca pela sua licença completa. Serve apenas uma vez.
  • Purga: a desinstalação completa de um pacote, incluídas as respostas de configuração. No Debian, apt remove remove o programa, apt purge remove também os seus ajustes.

Pré-requisitos

  • Uma máquina (VPS, mini-PC, servidor de escritório) com Ubuntu 24.04+, Debian 13+, ou Windows 10, 11, Server 2019+. O contêiner Docker cobre as demais distribuições.
  • Direitos de administração nessa máquina: root no Linux, na prática via sudo, ou um PowerShell «Executar como administrador» no Windows. O instalador se recusa a iniciar sem eles.
  • Seu código de ativação uVersion (formato UV-XXXX-XXXX-XXXX) recebido por e-mail quando sua licença é emitida, ou obtido em sua área de conta. Este código é de uso único: uma vez trocado, não pode mais servir em outra máquina.
  • Um acesso à Internet de saída para licence.uversion.io (HTTPS), durante a troca do código. Em uma rede sem acesso à Internet, veja a seção «Instalação não interativa e off-line» da página do Ubuntu: o instalador também aceita a chave de licença completa, que você obtém na sua área de conta em outra estação.
  • PostgreSQL. No Ubuntu e no Debian, ele chega automaticamente como dependência do pacote, você não precisa fazer nada. No Windows, o instalador o instala via winget, ausente do Windows Server 2019 e 2022: nessas duas versões, instale o PostgreSQL 16 manualmente antes de rodar o script.
  • Espaço em disco. O servidor em si e o banco de dados pesam pouco: é o repositório de fragmentos (o conteúdo dos seus arquivos, todas as revisões somadas) que domina, portanto dimensione conforme o tamanho dos seus projetos Unreal e seu histórico. Se você colocar também o banco de dados na pasta de dados, o instalador grava ali ainda um arquivo de lastro de 1 GB, a ser excluído em caso de disco cheio.
  • A porta TCP 8443 aberta na entrada, é por aí que suas estações se conectam. O instalador do Windows cria a regra de firewall sozinho. O pacote Debian não abre nenhuma porta: faça você mesmo, por exemplo sudo ufw allow 8443/tcp.

Escolha seu caminho

Ubuntu / Debian

Ubuntu 24.04+, Debian 13+. Instalação via pacote .deb.

sudo apt install ./uversion-server_*.deb

Windows

Windows 10, 11, Server 2019+. Uma única linha do PowerShell como Administrador.

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

Docker

Servidor e banco de dados em contêineres. A única via suportada na família Red Hat (RHEL, Rocky, AlmaLinux, Fedora).

docker compose up -d

HTTPS e certificado

O servidor fala somente HTTPS, na porta 8443. Não há nada a configurar e nenhum nome de domínio é necessário: no primeiro início, o servidor gera ele mesmo o seu certificado, chamado autoassinado, e exibe a sua impressão digital SHA-256 ao final da instalação. Cada estação confirma esta impressão digital uma única vez, na primeira conexão, e depois recusa qualquer impressão digital diferente.

Consequência visível: um navegador que abre https://<ip-do-servidor>:8443 exibe um aviso de segurança, porque este certificado não é assinado por nenhuma autoridade pública. Isso é esperado. Verifique que a impressão digital exibida é de fato a anotada na instalação e, em seguida, prossiga.

O aviso de seguranca exibido pelo navegador na primeira conexao ao servidor, com o botao que permite continuar.

Detalhe do procedimento do lado das estações: Impressão digital TLS. Se o seu servidor possui um nome de domínio e você já dispõe de um certificado, pode colocar o seu no lugar: veja a seção 2 do runbook de operações (docs/operations.md) entregue com o servidor.

E depois?

A instalação exibe, em um quadro, o usuário admin, uma senha temporária e o endereço do servidor. Anote-os. Em seguida, você se conecta de qualquer estação da rede, com um navegador ou o cliente desktop, no endereço https://<ip-do-servidor>:8443, onde <ip-do-servidor> é o endereço da máquina que você acabou de instalar.