# Instalando e atualizando Railbase em Linux com apt ou dnf

> Railbase publica um repositório de pacotes licenciado e assinado, então um servidor Linux o instala e atualiza da mesma forma que atualiza todo o resto na máquina.

_Updated: 2026-08-19_

Em Linux, Railbase é um pacote. Você pode baixar um `.deb` ou `.rpm` da sua conta e instalá-lo manualmente, mas em um servidor você geralmente deseja o oposto: Railbase deve ser atualizado junto com o resto da máquina, sob a mesma política e a mesma janela de manutenção de qualquer outro pacote que você executa.

É para isso que serve o repositório de pacotes Railbase.

## O que é isso

Um repositório apt e dnf assinado, publicado em `railbase.app`, contendo os mesmos pacotes que sua conta pode baixar do site. Vale a pena saber duas coisas sobre isso antes de configurá-lo.

**Está assinado.** Os metadados do repositório são assinados com a chave de empacotamento Railbase. Sua máquina é instruída a confiar nessa chave uma vez e, a partir de então, apt ou dnf recusa qualquer coisa que não tenha sido assinada por ela - que é o que torna um `apt upgrade` automatizado seguro para ser executado sem supervisão.

**Está licenciado.** Ao contrário de um espelho de distribuição, este repositório não é público. Cada solicitação carrega uma credencial vinculada à sua conta, e o direito é verificado em cada solicitação, e não uma vez na configuração. Se a conta expirar, as atualizações serão interrompidas; eles não continuam fluindo silenciosamente.

## Obtendo uma credencial

Faça login em sua conta, abra a seção **Deployments** e crie uma credencial de repositório Linux. Você verá os comandos exatos a serem executados, com a credencial já preenchida — copie-os para a máquina e execute-os lá.

A credencial é mostrada uma vez. Se você perder, crie outro; se uma máquina for desativada ou você suspeitar que uma credencial vazou, revogue-a na mesma página. A revogação entra em vigor na próxima solicitação e outras máquinas não são afetadas.

Dê um rótulo a cada credencial ("servidores de produção", "teste") para que a lista em sua conta permaneça legível daqui a um ano.

## Debian e Ubuntu

A configuração adiciona dois arquivos: a chave confiável e uma entrada da lista de fontes apontando para o repositório. Depois disso:

```
sudo apt update
sudo apt install railbase
```

e a partir daí `sudo apt upgrade` atualiza Railbase com todo o resto. Como a chave está fixada com `signed-by`, essa confiança se aplica apenas ao repositório Railbase — ela não dá autoridade à chave Railbase sobre qualquer outro pacote em seu sistema.

## RHEL, Fedora e Rocky

A configuração do dnf grava um único arquivo `.repo`. Ambos `gpgcheck` e `repo_gpgcheck` estão habilitados: os pacotes **e** os metadados do repositório são verificados em relação à chave Railbase.

```
sudo dnf install railbase
```

## Depois de instalar

O pacote instala Railbase como um serviço systemd com seus dados em `/var/lib/railbase`. As atualizações substituem o programa e deixam os dados em paz – seu arquivo `.vault`, arquivos carregados e configuração sobrevivem a uma atualização, como deveriam.

Para verificar o que você está executando:

```
railbase --version
systemctl status railbase
```

## Atualizações autônomas

Se você usa `unattended-upgrades` (Debian/Ubuntu) ou `dnf-automatic`, Railbase pode ser incluído como qualquer outra origem. Se você *deveria* é um julgamento sobre o seu ambiente: as atualizações automáticas mantêm o fluxo das correções de segurança sem que ninguém se lembre de agir, enquanto uma atualização manual programada lhe dá um momento para ler primeiro as notas de versão. Railbase suporta ambos; isso não decide por você.

## Se algo der errado

**`apt update` relata um erro de credencial.** A credencial foi revogada ou o direito da conta expirou. Verifique a seção Implantações da sua conta; uma nova credencial corrige o primeiro caso, e o segundo precisa da licença resolvida.

**`NO_PUBKEY` ou um erro de assinatura.** A chave confiável não foi instalada ou foi instalada em algum lugar onde o apt não a está lendo. Execute novamente a etapa principal na página da sua conta.

**Uma versão que você esperava está faltando.** O repositório publica o que sua conta tem direito. Se uma versão foi lançada e sua máquina não consegue vê-la, verifique primeiro a conta – o repositório deliberadamente não é mais permissivo do que a página de download.