Linux (.deb / .rpm)

Le core empaqueté pour votre distribution : il s'installe comme n'importe quel logiciel système, s'enregistre en service systemd et démarre avec la machine. C'est la méthode d'exploitation.

Pré-requis #

Debian ou Ubuntu pour le .deb ; Fedora, RHEL ou openSUSE pour le .rpm.
Un PostgreSQL 16 accessible — il n'est pas embarqué dans le paquet. Sur la même machine ou ailleurs, peu importe.
2 Go de RAM au minimum ; 4 Go et plus deviennent confortables dès que vous ajoutez des modules.

Note

Ni Rust ni Node.js ne sont nécessaires : les paquets contiennent le serveur déjà construit. Ces outils ne servent qu'à construire depuis les sources.

1. Télécharger le paquet #

Depuis la page Releases du core, prenez l'artefact de votre format. Le nom du .deb porte un identifiant de construction (par exemple kubuno-core_0.1.7-42.g4c9618c_amd64.deb) : les commandes ci-dessous utilisent donc un motif plutôt qu'un nom figé.

https://github.com/kubuno/core/releases/latest

2. Installer #

sudo apt install ./kubuno-core_*_amd64.deb

sudo dnf install ./kubuno-core-0.1.7-1.x86_64.rpm

sudo zypper install ./kubuno-core-0.1.7-1.x86_64.rpm

Le paquet crée le compte de service kubuno, installe l'unité systemd et démarre le service.

3. Vérifier le service #

sudo systemctl enable --now kubuno
systemctl status kubuno
journalctl -u kubuno -f

Ouvrez ensuite http://<votre-serveur>:8080/ : l'assistant d'installation prend la suite et écrit la configuration à votre place.

Où le paquet installe quoi #

/usr/bin/kubuno-core                 # le serveur
/usr/bin/kubuno                      # la console d'administration
/usr/share/kubuno/frontend/          # l'interface
/usr/share/kubuno/migrations/        # les migrations SQL
/etc/kubuno/config.toml              # la configuration
/usr/lib/kubuno/modules/<id>/        # les modules installés
/var/lib/kubuno/                     # données, thèmes, secrets d'instance
/var/backups/kubuno/                 # emplacement prévu pour vos sauvegardes
/var/log/kubuno/                     # les journaux

Note

Trois fichiers de /var/lib/kubuno méritent votre attention : data.key chiffre les secrets stockés — sauvegardez-la avec la base, sans elle vos sauvegardes seraient illisibles ; setup-token est le jeton de l'assistant, effacé dès l'installation terminée ; initial-admin-password n'existe que si le serveur a dû engendrer un mot de passe.

Mettre à jour #

Installez la nouvelle version par-dessus : votre configuration et vos données sont conservées.

sudo apt install ./kubuno-core_<nouvelle-version>_amd64.deb
sudo systemctl restart kubuno

sudo dnf upgrade ./kubuno-core-<nouvelle-version>.x86_64.rpm
sudo systemctl restart kubuno

Note

Enchaîner plusieurs installations de paquets peut faire buter systemd sur sa limite de redémarrages (start-limit-hit). Dans ce cas : sudo systemctl reset-failed kubuno && sudo systemctl restart kubuno.

Désinstaller #

sudo apt remove kubuno-core      # garde /etc/kubuno et /var/lib/kubuno
sudo apt purge  kubuno-core      # retire aussi la configuration

sudo dnf remove kubuno-core      # la configuration est conservée

Note

Dans tous les cas, la désinstallation conserve votre configuration, vos données, vos journaux, vos sauvegardes et la base PostgreSQL. Repartir vraiment de zéro demande de les supprimer vous-même.