Auto-hébergement : configuration essentielle
Cette page résume la configuration d’une instance auto-hébergée. Pour l’installation en quatre commandes, voir la page Auto-hébergement ; pour tout le reste (HTTPS avec Docker Swarm, sauvegardes, mises à jour, surveillance de l’instance), voir le guide complet, en anglais.
Les cinq valeurs à renseigner
Section intitulée « Les cinq valeurs à renseigner »Tout se règle par variables d’environnement, dans le fichier .env. Le serveur refuse de démarrer sur une configuration dangereuse ou incohérente, et dit laquelle, plutôt que de tourner en mode dégradé.
| Variable | À renseigner avec |
|---|---|
SECRET_KEY |
openssl rand -hex 32. Toutes les clés de signature en dérivent ; la changer déconnecte tout le monde. Les URL et secrets des webhooks de vos canaux sont chiffrés avec elle : après l’avoir changée, lancez OLD_SECRET_KEY=<ancienne> silencewatch reseal. Gardez-en une copie avec vos sauvegardes de base : sans elle, les canaux d’une sauvegarde sont illisibles. |
POSTGRES_PASSWORD |
openssl rand -hex 24. Le fichier Compose en construit DATABASE_URL. |
SMTP_URL |
smtp://utilisateur:motdepasse@relais.exemple.fr:587 (STARTTLS requis). Ou un POSTMARK_TOKEN / BREVO_API_KEY avec le EMAIL_PROVIDER correspondant. |
BASE_URL |
L’adresse que vos utilisateurs tapent. Les URL de ping et les liens des alertes en sont construits : une mauvaise valeur distribue des liens que personne ne peut suivre. |
ADMIN_EMAIL |
Votre propre adresse. Elle désigne l’administrateur, dont le compte voit les statistiques de l’instance et ne peut être créé qu’avec le lien à usage unique affiché dans le journal du serveur. |
Le fournisseur d’e-mail console (qui écrit les alertes dans le journal) n’est pas utilisable en production : le serveur refuse de démarrer avec.
Autres réglages courants
Section intitulée « Autres réglages courants »| Variable | Défaut | Effet |
|---|---|---|
AUTH_MODE |
passkey |
Comment on se connecte : passkey, password ou full (Google, Microsoft et passkey). Une passkey exige https:// ou localhost. Voir le guide d’authentification. |
SIGNUP_ENABLED |
true |
Si n’importe qui peut créer un compte. À false, seul le compte administrateur peut l’être. À fixer une fois votre équipe inscrite. |
PING_RETENTION_DAYS |
90 |
Durée de conservation de l’historique des pings. |
AUDIT_RETENTION_DAYS |
365 |
Durée de conservation de l’historique de sécurité. |
ALLOW_PRIVATE_NOTIFICATION_TARGETS |
false |
Autorise les alertes vers des adresses privées (protection contre le SSRF activée par défaut). |
OUTBOUND_HEARTBEAT_URL |
— | Un ping envoyé par SilenceWatch lui-même, pour surveiller le moniteur. |
LOG_LEVEL |
info |
Niveau de journalisation. |