Aller au contenu principal
Version : 0.4 · actuelle

Installer Excubius

Vue d'ensembleRévisé le 11 octobre 2026
S'applique à :Excubius 0.4Rôles : Installateur (administrateur Linux)
PlansFree · Core · Pro · EnterpriseDéploiementAuto-hébergé

Excubius s'exécute sur un seul serveur Linux que vous contrôlez, dans votre abonnement cloud ou votre centre de données. Le programme d'installation interactif vérifie le serveur, pose une courte série de questions, installe les conteneurs et obtient le certificat. Cet article indique ce dont vous avez besoin, ce que le programme d'installation demande et fait, et où trouver chacune des tâches qui suivent.

Avant de commencer​

ÉlémentConfiguration requise
ServeurRocky Linux 9 ou 10 (ou un autre système de la famille RHEL), x86-64, systemd. Au moins 2 vCPU, 4 Gio de mémoire et 20 Gio d'espace disque libre ; dans Azure, Standard_B2ms (2 vCPU, 8 Gio) est un bon point de départ et peut être redimensionné plus tard. Si votre équipe cloud crée les serveurs, consultez Demander le serveur Azure
AccèsUn compte avec sudo sur le serveur, accessible en SSH depuis votre poste de travail
Réseau vers les utilisateursPorts 80 et 443 libres sur le serveur et ouverts depuis les emplacements où les personnes utiliseront Excubius
SortantHTTPS vers ghcr.io et docker.io pour télécharger les images, sauf si vous utilisez le package hors connexion
Réseau vers ce que vous surveillezDepuis le serveur, le port SQL de chaque instance, de chaque réplica et de chaque adresse IP d'écouteur (et UDP 1434 pour les instances nommées sans port fixe), ainsi que HTTPS vers les points de terminaison web que vous testez. Rien ne se connecte au collecteur
Package d'installationexcubius-installer-<version>.tar.gz, ou le package hors connexion qui contient les images. Les utilisateurs connectés obtiennent les deux depuis Téléchargements
ConnexionUne inscription d'application Microsoft Entra ID, un client OAuth Google, ou les deux. Consultez Configurer les fournisseurs de connexion
Connexions de surveillanceDes connexions en lecture seule pour ce que vous allez surveiller, par exemple la connexion SQL Server décrite dans Prérequis pour les groupes de disponibilité
CertificatPour Let's Encrypt, un nom DNS public qui pointe vers le serveur, ou un accès par API à sa zone DNS. Inutile avec votre propre certificat, un certificat auto-signé ou une passerelle qui termine TLS

Fonctionnement de l'installation​

Les contrôles préalables portent sur le système d'exploitation et sa version, l'architecture, systemd et dnf, la mémoire, les processeurs, le disque, la disponibilité des ports 80 et 443, SELinux, l'accès aux registres ou à l'archive des images, et la synchronisation de l'horloge.

Le serveur reçoit le package de la version, un fichier de configuration et les images de conteneur. Il ne reçoit jamais de code source et ne contacte jamais de dépôt de code.

Installer​

  1. Copiez le package d'installation sur le serveur et décompressez-le :

    tar -xzf excubius-installer-0.4.0.tar.gz
    cd excubius-installer-0.4.0
  2. Si vous le souhaitez, exécutez uniquement les contrôles préalables. Ils ne modifient rien :

    sudo ./install.sh --check-only
  3. Exécutez le programme d'installation et répondez à ses questions. Appuyez sur Entrée pour accepter la valeur entre crochets :

    sudo ./install.sh

    Le programme d'installation conserve vos réponses, avec leur version, afin qu'une mise à niveau ne pose que les questions nouvelles de cette version.

  4. À la fin, ouvrez l'adresse publique qu'il affiche et connectez-vous avec le compte administrateur que vous avez nommé pendant l'installation. Ensuite, configurez la connexion et invitez les personnes qui utiliseront Excubius.

Tout ce que fait le programme d'installation est journalisé dans /var/log/excubius-install.log, sans les secrets.

Les questions du programme d'installation​

QuestionValeur par défautRemarques
Répertoire d'installation/opt/excubiusN'importe quel chemin absolu
Compte de serviceexcubiusCréé s'il n'existe pas. Il exécute les conteneurs sans privilèges root
URL publiquehttps://monitoring.example.comL'adresse que les personnes ouvriront. Son hôte est le nom principal du serveur
AliasAucunLes autres noms que les personnes peuvent ouvrir, séparés par des espaces, par exemple un alias dans un domaine que vous contrôlez
TLSletsencryptletsencrypt (via HTTP), letsencrypt-dns (via DNS), selfsigned, custom (vos fichiers PEM), gateway (TLS se termine en amont) ou later (HTTP simple pour l'instant)
Noms dans le certificatallDemandé lorsqu'il y a des alias : excluez les noms qu'un certificat ne peut pas couvrir
Adresse e-mail pour Let's Encrypt—Les deux modes Let's Encrypt
Fournisseur DNS et informations d'identification—letsencrypt-dns uniquement : l'identifiant dnsapi d'acme.sh, par exemple dns_cf, dns_dreamhost ou dns_azure, et ses variables, saisies une par une sans écho
Fichiers du certificat et de la clé—custom uniquement : la chaîne PEM, avec le certificat du serveur en premier, et une clé non chiffrée
Nom d'utilisateur et mot de passe de l'administrateurUn nom d'utilisateur suggéréLe compte de la première connexion, à l'adresse que le programme d'installation affiche à la fin. Le mot de passe compte au moins 12 caractères et il est demandé deux fois
Préréglage de baseenterpriseenterprise, databases ou core ; consultez Configurer l'instance
Utilisateur et jeton du registre—Fournis avec la licence. Non demandés avec le package hors connexion
Jeton du bot Slack et canal— et #alertsFacultatifs ; vous pouvez les définir plus tard. Consultez Configurer les notifications Slack
ID de locataire, ID client et secret Entra ID—Facultatifs ; vous pouvez les définir plus tard

Avec un mode Let's Encrypt, le programme d'installation vérifie ensuite les noms dans le DNS public et, via HTTP, qu'ils pointent vers ce serveur. Si ce n'est pas le cas, il explique les solutions possibles ; il ne s'arrête jamais pour autant.

Le programme d'installation génère une seule fois le mot de passe de la base de données, le secret de signature des sessions, la clé qui chiffre les secrets stockés et le jeton du collecteur, et ne les demande jamais. Une fois que la plateforme a stocké le mot de passe de l'administrateur, les informations d'identification DNS et une clé privée, il les supprime du fichier de configuration.

Pour installer sans questions, transmettez les réponses dans un fichier avec --answers ; consultez la référence du programme d'installation.

Noms et TLS​

ModeQuand l'utiliser
Let's Encrypt, validation HTTPLe nom se résout publiquement vers le serveur et le port 80 est accessible depuis Internet
Let's Encrypt, validation DNSLe serveur est privé, mais vous pouvez créer des enregistrements DNS via une API
Votre propre certificatVotre organisation émet des certificats
Auto-signéUn laboratoire ou un premier test
PasserelleUn équilibreur de charge ou un proxy inverse placé en amont termine TLS
HTTP simpleUn premier test, ou un réseau auquel vous faites entièrement confiance

Vous pouvez modifier les noms et le certificat plus tard depuis Settings sans réinstaller, et le renouvellement est automatique. Consultez Configurer les noms et TLS.

Mettre à niveau, réinstaller ou désinstaller​

CommandeCe qu'elle fait
sudo ./install.sh sur un serveur déjà installéPropose Upgrade (conserve les données et ne pose que les nouvelles questions), Reinstall, Purge and install fresh ou Cancel
sudo ./install.sh --uninstallEffectue une dernière sauvegarde de la base de données, puis supprime les services et les images. Conserve les données, les sauvegardes et la configuration
sudo ./install.sh --uninstall --purgeSupprime aussi les données, les sauvegardes et le compte de service. Vous demande de taper purge
attention

Effectuez la mise à niveau pendant une fenêtre de changement. Les services redémarrent pendant quelques secondes et les migrations de la base de données s'exécutent. Lisez les problèmes connus de la version avant de commencer.

--dry-run fonctionne avec chaque commande et affiche seulement ce qui se passerait. Les étapes pour mettre à niveau, revenir à la version précédente, sauvegarder et restaurer se trouvent dans Mettre à niveau, sauvegarder et restaurer, réservé aux utilisateurs connectés.

Surveiller Excubius depuis l'extérieur​

Excubius ne doit pas être le seul à se surveiller lui-même. Inscrivez https://<your server>/heartbeat auprès d'un observateur externe, par exemple un test de disponibilité Azure Monitor, Uptime Kuma exécuté ailleurs ou un service de type healthchecks, et configurez-le pour qu'il vous alerte lorsque l'adresse cesse de répondre ok. Si le serveur s'arrête, c'est cet observateur qui vous prévient.

/heartbeat et /healthz répondent en HTTP simple dans tous les modes TLS. /healthz renvoie aussi la version en cours d'exécution.

Étapes suivantes​