Héberger Checkmate sur un VPS infogéré : votre supervision, sur votre serveur

Héberger Checkmate sur un VPS infogéré, c'est garder la surveillance de vos sites et de vos serveurs sur une machine à vous, que nos équipes tiennent à jour et supervisent jour et nuit. Checkmate est une application libre de supervision, sous licence AGPL-3.0 : disponibilité, temps de réponse, incidents, alertes et pages de statut. Ce guide suit son image Docker officielle, à la version v4.0.0, et nous avons lancé chaque commande sur un VPS Simafri avant de l'écrire : l'installation avec Docker Compose, HTTPS, le premier compte, les sondes et les alertes, les sauvegardes et les mises à jour.

Simon Vasconcelos Lee Par Publié le 17 novembre 2026Lecture : 12 minutes

Tous les guides

L'essentiel

  1. La licence AGPL-3.0 permet de faire tourner Checkmate pour vous, votre équipe ou vos clients, sans licence à acheter ; si vous le modifiez et le laissez utiliser à d'autres par le réseau, vous partagez vos modifications.
  2. Installez-le avec Docker Compose : l'image tout-en-un ghcr.io/bluewave-labs/checkmate et MongoDB 8.0, avec le port publié sur 127.0.0.1 derrière un proxy inverse en HTTPS.
  3. Choisissez JWT_SECRET, ENCRYPTION_KEY et votre adresse publique dans CLIENT_HOST, et ajoutez NODE_ENV=production, que le fichier de référence omet.
  4. La première personne qui s'inscrit devient Superadmin : créez votre compte juste après le premier démarrage, puis chacun des autres rejoint l'instance sur invitation.
  5. Sauvegardez la base MongoDB avec mongodump et gardez votre fichier .env, puis mettez à jour en changeant l'étiquette de l'image : les migrations se lancent seules au démarrage.

Ce que fait Checkmate

Checkmate interroge vos services à intervalles réguliers, enregistre chaque réponse et son temps de réponse, et vous alerte quand quelque chose ne répond plus. Son éditeur, BlueWave Labs, le présente comme un outil auto-hébergé pour suivre en temps réel le matériel des serveurs, la disponibilité, les temps de réponse et les incidents.

Ce que permet la licence AGPL-3.0

Checkmate est publié sous la GNU Affero General Public License, version 3 (AGPL-3.0). Vous pouvez l'utiliser gratuitement, pour vous, votre entreprise ou vos clients, le copier et le modifier.

Sa clause particulière porte sur l'usage en réseau : si vous modifiez Checkmate et laissez d'autres personnes utiliser votre version modifiée par le réseau, vous devez leur proposer son code source. Faire tourner l'image officielle sans la modifier, comme dans ce guide, ne crée aucune obligation de ce type. Le logiciel est fourni sans garantie.

Les ressources à prévoir

La documentation fixe un plancher modeste : n'importe quel VPS Linux doté d'au moins 1 Go de mémoire vive. Elle ajoute que MongoDB occupe environ 400 Mo sur une instance qui interroge plus de 300 serveurs chaque minute.

La taille du serveur dépend donc du nombre de sondes, de leur intervalle et de l'historique que vous gardez. Sur un VPS infogéré, décrivez-nous votre usage, et nous vous recommandons la taille qui convient.

L'installation avec Docker Compose

Depuis la version 3.10, Checkmate se livre en une seule image, ghcr.io/bluewave-labs/checkmate, qui sert à la fois l'interface et l'API. MongoDB tourne à côté, dans son propre conteneur. Sur un serveur doté de Docker Engine et de son extension Compose, installés depuis le dépôt de Docker pour Ubuntu, créez un dossier comme /opt/checkmate et placez-y ce compose.yaml, qui reprend le fichier de référence du projet :

compose.yaml
services:
  checkmate:
    image: ghcr.io/bluewave-labs/checkmate:v4.0.0
    restart: always
    ports:
      - "127.0.0.1:52345:52345"
    environment:
      - DB_CONNECTION_STRING=mongodb://mongodb:27017/uptime_db
      - CLIENT_HOST=https://status.example.com
      - JWT_SECRET=${JWT_SECRET:?set JWT_SECRET in .env}
      - ENCRYPTION_KEY=${ENCRYPTION_KEY:?set ENCRYPTION_KEY in .env}
      - NODE_ENV=production
    stop_grace_period: 60s
    healthcheck:
      test: ["CMD", "node", "-e", "require('http').get('http://localhost:52346/livez',r=>process.exit(r.statusCode===200?0:1)).on('error',()=>process.exit(1))"]
      interval: 15s
      timeout: 3s
      start_period: 60s
      start_interval: 2s
      retries: 3
    depends_on:
      mongodb:
        condition: service_healthy

  mongodb:
    image: mongo:8.0
    restart: always
    command: ["mongod", "--quiet", "--bind_ip_all"]
    volumes:
      - mongo-data:/data/db
    healthcheck:
      test: ["CMD", "bash", "-c", "exec 3<>/dev/tcp/127.0.0.1/27017"]
      interval: 5s
      timeout: 30s
      start_period: 0s
      start_interval: 1s
      retries: 30

volumes:
  mongo-data:

Les deux secrets vont dans un fichier .env posé à côté, que Docker Compose lit de lui-même. Créez-le lisible par root seul, puis démarrez la pile :

Terminal, dans /opt/checkmate
umask 077
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -base64 32)" > .env
umask 022
docker compose up -d
docker compose ps

Le premier démarrage lance les migrations de la base ; sur notre VPS de test, l'application s'est déclarée en bonne santé en moins de dix secondes. Pour vérifier qu'elle répond :

Terminal
curl -s -o /dev/null -w "%{http_code}\n" http://127.0.0.1:52345/
curl -s http://127.0.0.1:52345/api/v1/auth/users/superadmin

La première commande répond 200. La seconde répond "data":false tant qu'aucun compte n'existe, et true une fois le Superadmin créé.

Le premier compte, les rôles et les invitations

Checkmate n'a aucun compte par défaut. La première personne qui s'inscrit devient Superadmin : créez donc le vôtre juste après le premier démarrage, avant d'ouvrir l'adresse au public. Un tunnel SSH fait apparaître le port 52345 du serveur sur votre poste, à l'adresse http://localhost:52345 ; ajoutez -p et le port SSH affiché dans votre espace client.

Terminal, sur votre poste
ssh -L 52345:127.0.0.1:52345 root@status.example.com
  1. Ouvrez http://localhost:52345 : Checkmate affiche sa page d'inscription.
  2. Saisissez votre prénom, votre nom, votre adresse e-mail et un mot de passe de 8 caractères au moins, avec une majuscule, une minuscule, un chiffre et un caractère spécial.
  3. Inscrivez-vous : vous arrivez sur le tableau de bord, connecté en Superadmin.

Dès lors, l'inscription publique est fermée : sur notre VPS de test, chaque nouveau visiteur était renvoyé vers la page de connexion, et l'adresse d'inscription y menait aussi. Les autres personnes rejoignent l'instance sur invitation, depuis la section Team des réglages du compte, avec le rôle User ou Admin. L'invitation part par e-mail, elle demande donc les réglages SMTP présentés plus bas, et son lien expire au bout d'une heure.

RôleCe qu'il peut faire
UserVoir toutes les sondes, le tableau de bord, les contrôles, les incidents, les pages de statut et les réglages, sans rien modifier
AdminTout ce que peut un User, plus les sondes, les canaux de notification, les incidents, les fenêtres de maintenance, les pages de statut, les invitations et les réglages généraux, SMTP compris
SuperadminTout ce que peut un Admin, plus la création directe de comptes, la modification d'un autre utilisateur, le changement d'un rôle ou d'un mot de passe

Depuis la v4.0.0, les étiquettes, les pages de statut et les proxys relèvent du rôle Admin : un User qui pouvait les gérer auparavant perd cet accès après la mise à jour.

HTTPS : le proxy inverse

Le conteneur sert Checkmate en HTTP, sur le port 52345. HTTPS se règle sur un proxy inverse placé devant : la documentation cite Caddy, Traefik et nginx. Nous avons testé Caddy, installé depuis son dépôt officiel pour Debian et Ubuntu : il obtient lui-même le certificat Let's Encrypt, le renouvelle, et transmet par défaut l'en-tête Host et les en-têtes X-Forwarded-*.

/etc/caddy/Caddyfile
status.example.com {
	reverse_proxy 127.0.0.1:52345
}
Terminal
sudo systemctl reload caddy

Votre première sonde et ses alertes

  1. Dans « Uptime », cliquez sur « Create monitor » et choisissez HTTP/HTTPS.
  2. Saisissez l'adresse à contrôler, un nom que vous reconnaîtrez dans une alerte, et un intervalle : la documentation recommande d'une à cinq minutes pour un service critique.
  3. Enregistrez : Checkmate lance aussitôt le premier contrôle. Sur notre VPS de test, la sonde était en ligne une minute plus tard.

Les e-mails : les réglages SMTP

Les alertes par e-mail et les invitations passent par une connexion SMTP commune à tout le serveur, réglée dans « Settings », onglet « Email » : serveur, port, utilisateur, mot de passe et adresse d'expédition, puis « Save » et « Test ». Sur un VPS Simafri, utilisez un serveur SMTP authentifié, sur le port 587 ou 465 : celui de la messagerie de votre domaine, ou d'un service d'envoi. Créez ensuite une notification par e-mail avec les adresses à alerter, et rattachez-la à vos sondes.

Slack, Discord, Teams, Telegram et les autres canaux se créent de la même façon, dans « Notifications », chacun avec son adresse de webhook ou son jeton, et chacun avec un bouton « Test ».

Les sondes Heartbeat pour vos tâches planifiées

Une sonde Heartbeat surveille une tâche qui tourne seule, comme une sauvegarde de nuit. Générez la clé de ping de l'équipe dans « Settings », onglet « Monitoring » (elle ne s'affiche qu'une fois), créez une sonde Heartbeat avec un slug et une fenêtre d'alerte, puis appelez son URL de ping à la fin de la tâche :

crontab
0 3 * * * /usr/local/bin/backup.sh && curl -fsS -m 10 --retry 3 "https://status.example.com/api/v1/heartbeat/<ping-key>/nightly-backup"

Ajouter /fail, ou le code de sortie de la tâche, à l'URL fait passer la sonde en panne aussitôt, sans attendre la fin de la fenêtre.

Les pages de statut

Dans « Status pages », un Admin publie une page qui liste les sondes choisies et leur disponibilité, pour vos clients ou votre équipe. Depuis la v4.0.0, chaque page de statut a un fuseau horaire, UTC par défaut.

Les sauvegardes

Tout vit à deux endroits : la base MongoDB, dans le volume mongo-data, et votre fichier .env. Gardez ce dernier à l'abri : ENCRYPTION_KEY sert à lire les secrets enregistrés dans la base, et JWT_SECRET garde vos utilisateurs connectés. L'image MongoDB contient mongodump :

Terminal, dans /opt/checkmate
docker compose exec -T mongodb mongodump --archive --gzip --db uptime_db > checkmate-$(date +%F).archive.gz
cp .env env-$(date +%F).bak

Planifiez cette copie et envoyez-la hors du serveur ; une sonde Heartbeat peut vous prévenir si elle cesse un jour de tourner. Posées sur le disque, les archives entrent aussi dans les sauvegardes de nuit du serveur.

Restaurer

Sur la même installation ou sur une nouvelle, avec le même .env, arrêtez l'application, chargez l'archive, puis redémarrez-la :

Terminal, dans /opt/checkmate
docker compose stop checkmate
docker compose exec -T mongodb mongorestore --archive --gzip --drop < checkmate-2026-11-17.archive.gz
docker compose start checkmate

Nous avons testé le cycle complet sur notre VPS : sauvegarde, base réellement supprimée, restauration. La sonde et le compte sont revenus, et la connexion a de nouveau fonctionné aussitôt.

Checkmate v4.0.0 propose aussi des sauvegardes chiffrées dans le cloud par Checkmate Connect, un service facultatif, gratuit pendant sa bêta, qui demande ENCRYPTION_KEY et un Superadmin pour inscrire l'installation. Les copies ci-dessus fonctionnent sans lui.

Les mises à jour

Lisez les notes de version, faites une sauvegarde, changez l'étiquette de l'image dans le compose.yaml, puis tirez la nouvelle image et recréez le conteneur. Les migrations de la base se lancent seules au démarrage :

Terminal, dans /opt/checkmate
docker compose pull
docker compose up -d
docker compose logs checkmate | grep -i migration

La télémétrie

Checkmate envoie un rapport anonyme par jour : un identifiant d'installation, la version, le mode d'installation et le nombre de sondes de chaque type, jamais vos URL ni vos résultats. Il l'annonce dans son journal au démarrage. Pour la désactiver, ajoutez TELEMETRY_ENABLED=false à l'environnement du service checkmate, puis lancez docker compose up -d.

Qui fait quoi sur un VPS infogéré

L'auto-hébergement demande de tenir le serveur en plus de l'application. Sur un VPS infogéré, nos équipes prennent le serveur en main et suivent votre instance de manière proactive ; Checkmate reste votre logiciel, avec ses sondes et vos réglages.

SujetNos équipesVous
Le serveurMises à jour du système et de la sécurité, interventions sur le serveur comprisesLe moment qui convient à votre activité
La supervisionServeur suivi 24 h/24 et 7 j/7, avec intervention sans attendre votre appelVos propres sondes, alertes et pages de statut dans Checkmate
CheckmateSuivi proactif : erreurs, lenteurs, base de données et espace disque repérés, correction recommandéeSon installation, ses mises à jour et ses réglages, que vous appliquez, vous ou votre assistant IA
Les utilisateurs et les alertesLe serveur qui les porte, surveillé et sauvegardéLes comptes, les rôles, les invitations et les canaux de notification
Les sauvegardesChaque nuit, chiffrées et gardées hors de la machine ; restauration compriseLes exports de base propres à Checkmate, et la demande de restauration, quand vous en avez besoin
La migrationVotre serveur actuel migré, offertLe moment de la bascule

Si vous préférez que nos équipes interviennent dans l'application elle-même, cette prestation se facture à l'heure ou au forfait, avec un chiffrage communiqué avant l'intervention.

Checkmate, sur un serveur tenu pour vous

Avec un VPS infogéré Simafri, nos équipes tiennent à jour le serveur de votre instance Checkmate, le surveillent jour et nuit et interviennent sans attendre votre appel ; elles suivent aussi votre instance de manière proactive et vous recommandent les corrections utiles, que vous appliquez, vous ou votre assistant IA. Les sauvegardes sont chiffrées chaque nuit et gardées hors de la machine, leur restauration est comprise, et la migration de votre serveur actuel est offerte.

Découvrir les VPS infogérés

Questions fréquentes

Checkmate est-il gratuit ?

Oui. Checkmate est sous licence AGPL-3.0 : vous pouvez le faire tourner pour vous, votre équipe ou vos clients, sans licence à acheter. Si vous le modifiez et le laissez utiliser à d'autres par le réseau, vous partagez vos modifications. Reste le coût du serveur qui le fait tourner.

Comment installer Checkmate avec Docker Compose ?

Reprenez le compose.yaml de référence : l'image ghcr.io/bluewave-labs/checkmate et MongoDB 8.0. Placez JWT_SECRET et ENCRYPTION_KEY dans un fichier .env, réglez CLIENT_HOST sur votre adresse en https et NODE_ENV sur production, publiez le port 52345 sur 127.0.0.1, lancez docker compose up -d, et placez un proxy inverse en HTTPS devant.

Quels sont les identifiants par défaut de Checkmate ?

Il n'y en a pas. La première personne qui s'inscrit sur une nouvelle instance devient Superadmin. Créez votre compte juste après le premier démarrage, par un tunnel SSH ; ensuite, les visiteurs sont renvoyés vers la page de connexion et les nouveaux utilisateurs rejoignent l'instance sur invitation.

De combien de mémoire Checkmate a-t-il besoin ?

La documentation demande un VPS Linux doté d'au moins 1 Go de mémoire vive. Sur notre VPS de test, une installation neuve occupait environ 300 Mo pour Checkmate et 280 Mo pour MongoDB. Le disque grandit avec le nombre de sondes, leur intervalle et l'historique que vous gardez, 90 jours par défaut.

Comment envoyer les alertes de Checkmate par e-mail ?

Réglez la connexion SMTP dans Settings, onglet Email : serveur, port 587 ou 465, utilisateur, mot de passe et expéditeur, puis Save et Test. Créez une notification par e-mail avec les adresses à alerter et rattachez-la à vos sondes. Les invitations utilisent les mêmes réglages.

Comment sauvegarder Checkmate ?

Exportez la base MongoDB avec docker compose exec -T mongodb mongodump --archive --gzip --db uptime_db, et gardez une copie de votre fichier .env, dont la variable ENCRYPTION_KEY sert à lire les secrets enregistrés. Restaurez avec mongorestore --archive --gzip --drop, l'application arrêtée.

Comment mettre à jour Checkmate ?

Lisez les notes de version et faites une sauvegarde, changez l'étiquette de l'image dans compose.yaml, puis lancez docker compose pull et docker compose up -d. Les migrations de la base se lancent seules au démarrage.

Un VPS infogéré couvre-t-il Checkmate ?

Un VPS infogéré couvre le serveur : système, sécurité, supervision et sauvegardes. Nos équipes suivent aussi votre instance de manière proactive et vous recommandent les corrections utiles, que vous appliquez. Une intervention dans l'application se facture à l'heure ou au forfait.

Sources et documentation officielle

Guides liés

Héberger Uptime Kuma sur un VPS infogéré : surveillez vos services en continuHéberger Uptime Kuma sur un VPS infogéré, c'est surveiller vos sites, vos API et vos serveurs depuis une machine à vous, que nos équipes tiennent à jour et supervisent jour et nuit. Uptime Kuma est un logiciel libre sous licence MIT. Ce guide suit sa documentation officielle : l'installation avec Docker Compose, HTTPS, la base de données, les notifications, les sauvegardes et les mises à jour.Sauvegardes d'un VPS : ce qu'il faut vérifier avant de signerUne offre de VPS annonce presque toujours « sauvegardes comprises ». Derrière ces deux mots, il peut y avoir une copie chaque nuit, gardée hors de la machine et restaurée par des experts, ou un instantané posé sur le même disque que le serveur. Ce guide donne les questions qui font la différence, ce que chaque réponse veut dire, et la façon de vérifier qu'une sauvegarde se restaure.Différence entre VPS infogéré et non infogéré : qui fait quoiLa différence entre un VPS infogéré et un VPS non infogéré tient à une question : qui s'occupe du serveur une fois qu'il tourne. Le mot « infogéré » n'a pourtant pas de définition officielle, et va d'un hébergeur à l'autre d'une simple installation du système à l'exploitation complète du serveur. Ce guide montre qui fait quoi, ligne par ligne, avec le niveau intermédiaire de l'assistance, et donne les questions qui lèvent l'ambiguïté avant de signer.
Contactez-nous