Wiki

Instalar no Ubuntu / Debian

O pacote .deb com debconf: código de ativação, PostgreSQL, serviço systemd, TLS autoassinado.

Ubuntu 24.04+, Debian 13+ (x86_64). 3 passos.

Instalar

Baixar o pacote
```
cd /tmp && wget -N https://uversion.io/downloads/server/uversion-server_latest_amd64.deb
```
A URL _latest_ sempre aponta para a versão publicada mais recente. A flag -N diz ao wget para baixar novamente apenas se o arquivo remoto for mais recente: útil para atualizar sem acumular cópias .deb.1, .deb.2, etc. cd /tmp evita um aviso cosmético do apt ("unsandboxed as root") quando o .deb está no seu diretório home.
Instalar
```
sudo apt install ./uversion-server_latest_amd64.deb
```
O instalador solicita:

Campo Padrão Obrigatório

Código de ativação · Sim

Diretório de dados /var/lib/uversion Modificável

O postinst contata licence.uversion.io para trocar o código pela sua chave de licença completa e gravá-la em /etc/uversion/config.toml. Um certificado TLS autoassinado é gerado na primeira inicialização; sua impressão digital SHA-256 é exibida ao final da instalação. Veja Impressão digital TLS.
Pronto. O código de administrador inicial é exibido ao final da instalação em uma caixa colorida. Se você perdeu:
```
sudo cat /var/lib/uversion/initial-admin-password
```

O resumo exibido no fim da instalação: usuário admin, senha temporária e endereço do servidor.

Em seguida, você pode seguir Primeiro login.

Verificar a instalação

systemctl status uversion-server              # active (running)
ss -tlnp | grep 8443                          # le service ecoute en HTTPS sur 8443
sudo cat /var/lib/uversion/data/tls/fingerprint  # empreinte TLS (a re-afficher)
sudo journalctl -u uversion-server -n 50      # logs recents

Desinstalar

Atenção: os comandos abaixo removem seus repositórios, histórico, contas de usuário e configurações. Faça um backup do PostgreSQL (pg_dump uversion) e copie /var/lib/uversion/ se quiser poder restaurar.

O apt purge remove o binário, a unit systemd, as respostas do debconf e (via script postrm) /etc/uversion/ bem como o usuário do sistema uversion. Apenas o banco PostgreSQL e o diretório de dados /var/lib/uversion/ (criados pelo script postinst) são deliberadamente preservados e devem ser limpos manualmente.

Procedimento completo:

# 1. Arrêter le service
sudo systemctl stop uversion-server 2>/dev/null
sudo systemctl disable uversion-server 2>/dev/null

# 2. Purge du paquet
sudo apt purge -y uversion-server

# 3. Forcer debconf à oublier les réponses du paquet
echo PURGE | sudo debconf-communicate uversion-server 2>/dev/null || true

# 4. Base PostgreSQL + role
sudo -u postgres psql -c "DROP DATABASE IF EXISTS uversion;"
sudo -u postgres psql -c "DROP ROLE IF EXISTS uversion;"

# 5. Data dir (chunks + initial-admin-password)
sudo rm -rf /var/lib/uversion

# 6. User système (normalement déjà retiré par 'apt purge' via postrm ; sans effet si absent)
sudo deluser --remove-home uversion 2>/dev/null || sudo userdel uversion 2>/dev/null

Verificação:

systemctl status uversion-server                                # "not-found" ou "inactive"
ls /etc/uversion /var/lib/uversion 2>&1                         # "No such file"
which uversion-server                                           # (vide)
sudo -u postgres psql -tAc "SELECT 1 FROM pg_database WHERE datname='uversion';"   # (vide)
sudo -u postgres psql -tAc "SELECT 1 FROM pg_roles WHERE rolname='uversion';"      # (vide)
id uversion                                                     # "no such user"

Campo	Padrão	Obrigatório
Código de ativação	·	Sim
Diretório de dados	`/var/lib/uversion`	Modificável