# Installation et mise à jour de Railbase sur Linux avec apt ou dnf

> Railbase publie un référentiel de packages signé et sous licence, donc un serveur Linux l'installe et le met à jour de la même manière qu'il met à jour tout le reste sur la machine.

_Updated: 2026-08-19_

Sur Linux, Railbase est un package. Vous pouvez télécharger un `.deb` ou `.rpm` depuis votre compte et l'installer manuellement, mais sur un serveur, vous souhaitez généralement le contraire : Railbase doit être mis à jour en même temps que le reste de la machine, selon la même politique et la même fenêtre de maintenance que tous les autres packages que vous exécutez.

C'est à cela que sert le référentiel de packages Railbase.

## Qu'est-ce que c'est

Un référentiel apt et dnf signé, publié sur `railbase.app`, contenant les mêmes packages que votre compte peut télécharger depuis le site Web. Deux choses méritent d’être connues avant de le configurer.

**Il est signé.** Les métadonnées du référentiel sont signées avec la clé d'empaquetage Railbase. Il est demandé à votre machine de faire confiance à cette clé une fois, puis apt ou dnf refuse tout ce qui n'a pas été signé par elle - ce qui permet à un `apt upgrade` automatisé de s'exécuter en toute sécurité sans surveillance.

**Il est sous licence.** Contrairement à un miroir de distribution, ce référentiel n'est pas public. Chaque demande comporte un identifiant lié à votre compte, et les droits sont vérifiés à chaque demande plutôt qu'une seule fois lors de la configuration. Si le compte expire, les mises à jour s'arrêtent ; ils ne continuent pas à couler tranquillement.

## Obtenir un identifiant d'accès

Connectez-vous à votre compte, ouvrez la section **Deployments** et créez un identifiant de référentiel Linux. Vous verrez les commandes exactes à exécuter, avec les informations d'identification déjà renseignées : copiez-les sur la machine et exécutez-les là-bas.

Les informations d'identification sont affichées une fois. Si vous le perdez, créez-en un autre ; si une machine est mise hors service ou si vous soupçonnez une fuite d'informations d'identification, révoquez-la à partir de la même page. La révocation prend effet à la demande suivante et les autres machines ne sont pas affectées.

Donnez à chaque identifiant une étiquette (« serveurs de production », « staging ») afin que la liste de votre compte reste lisible dans un an.

## Debian et Ubuntu

Le programme d'installation ajoute deux fichiers : la clé de confiance et une entrée de liste source pointant vers le référentiel. Après cela :

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

et à partir de là, `sudo apt upgrade` met à jour Railbase avec tout le reste. Étant donné que la clé est épinglée avec `signed-by`, cette confiance s'applique uniquement au référentiel Railbase — elle ne donne pas à la clé Railbase l'autorité sur tout autre package de votre système.

## RHEL, Fedora et Rocky

La configuration dnf écrit un seul fichier `.repo`. `gpgcheck` et `repo_gpgcheck` sont activés : les packages **et** et les métadonnées du référentiel sont vérifiées par rapport à la clé Railbase.

```
sudo dnf install railbase
```

## Après l'installation

Le package installe Railbase en tant que service systemd avec ses données sous `/var/lib/railbase`. Les mises à niveau remplacent le programme et laissent les données tranquilles : votre fichier `.vault`, les fichiers téléchargés et la configuration survivent à une mise à niveau, comme ils le doivent.

Pour vérifier ce que vous exécutez :

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

## Mises à niveau sans surveillance

Si vous utilisez `unattended-upgrades` (Debian/Ubuntu) ou `dnf-automatic`, Railbase peut être inclus comme n'importe quelle autre origine. Que vous *devriez* est un jugement sur votre environnement : les mises à jour automatiques maintiennent les correctifs de sécurité en continu sans que personne ne se souvienne d'agir, tandis qu'une mise à niveau manuelle planifiée vous donne un moment pour lire d'abord les notes de version. Railbase prend en charge les deux ; il ne décide pas à votre place.

## Si quelque chose ne va pas

**`apt update` signale une erreur d'identifiant.** L'identifiant a été révoqué ou les droits du compte ont expiré. Vérifiez la section Déploiements de votre compte ; un nouveau titre résout le premier cas et le second nécessite que la licence soit réglée.

**`NO_PUBKEY` ou une erreur de signature.** La clé de confiance n'a pas été installée ou a été installée à un endroit où apt ne la lit pas. Réexécutez l'étape clé à partir de la page de votre compte.

**Une version attendue est manquante.** Le référentiel publie ce à quoi votre compte a droit. Si une version est disponible et que votre ordinateur ne peut pas la voir, vérifiez d'abord le compte : le référentiel n'est délibérément pas plus permissif que la page de téléchargement.