{"id":3366,"date":"2025-04-17T22:10:40","date_gmt":"2025-04-17T20:10:40","guid":{"rendered":"https:\/\/hinakuu.xyz\/?p=3366"},"modified":"2025-04-24T19:01:00","modified_gmt":"2025-04-24T17:01:00","slug":"uptime-kuma-installation-debian-12","status":"publish","type":"post","link":"https:\/\/hinakuu.xyz\/?p=3366","title":{"rendered":"Uptime Kuma\u00a0installation Debian 12"},"content":{"rendered":"\n

Dans ce tutoriel, nous allons expliquer \u00e9tape par \u00e9tape comment installer Uptime Kuma sur Debian 12.<\/p>\n\n\n\n

Uptime Kuma (ou simplement Kuma) est un outil de surveillance open source permettant de surveiller les services HTTP, HTTPS, DNS et autres protocoles. Uptime Kuma offre diverses fonctionnalit\u00e9s, telles que le multilinguisme, plusieurs pages d’\u00e9tat, la prise en charge des proxys, etc.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Github : https:\/\/github.com\/louislam\/uptime-kuma\/wiki\/%F0%9F%94%A7-How-to-Install<\/a><\/p>\n\n\n\n

Configuration SSL possible : https:\/\/github.com\/louislam\/uptime-kuma\/wiki\/Reverse-Proxy<\/a><\/p>\n\n\n\n

Guide de configuration Uptime-Kuma : https:\/\/betterstack.com\/community\/guides\/monitoring\/uptime-kuma-guide\/<\/a><\/p>\n\n\n\n

Dans cet article, nous allons configurer Uptime Kuma avec Apache comme proxy inverse. L’installation d’Uptime Kuma sur Debian 12 avec Apache comme proxy inverse.<\/p>\n\n\n\n

\u00c9tape 1. Mettre \u00e0 jour le syst\u00e8me<\/mark><\/h2>\n\n\n\n

Chaque nouvelle installation du syst\u00e8me d’exploitation n\u00e9cessite que les packages syst\u00e8me soient mis \u00e0 jour vers les derni\u00e8res versions disponibles.<\/p>\n\n\n\n

sudo apt-get update -y && sudo apt-get upgrade -y<\/mark><\/pre>\n\n\n\n
Si une mise \u00e0 jour du noyau est en attente, vous devrez red\u00e9marrer votre ordinateur pour que la nouvelle version soit charg\u00e9e. Une fois les mises \u00e0 jour termin\u00e9es, vous pourrez passer \u00e0 l’\u00e9tape suivante.<\/p>\n\n\n\n
\u00c9tape 2. Installer le serveur Web Apache<\/mark><\/h2>\n\n\n\n
Pour installer Apache, ex\u00e9cutez la commande suivante :<\/p>\n\n\n\n
sudo apt install apache2 -y<\/mark><\/pre>\n\n\n\n
Une fois Apache install\u00e9, vous pouvez d\u00e9marrer et activer le service comme suit :<\/p>\n\n\n\n
sudo systemctl enable apache2 && sudo systemctl start apache2<\/mark><\/pre>\n\n\n\n
V\u00e9rifiez si le service est op\u00e9rationnel :<\/p>\n\n\n\n
sudo systemctl status apache2<\/mark><\/pre>\n\n\n\n
Vous devriez recevoir le r\u00e9sultat suivant :<\/p>\n\n\n\n
root@host:~# sudo systemctl status apache2\n\u25cf apache2.service - The Apache HTTP Server\n     Loaded: loaded (\/lib\/systemd\/system\/apache2.service; enabled; preset: enabled)\n     Active: active (running) since Wed 2023-10-05 06:26:23 CDT; 1 day 5h ago\n       Docs: https:\/\/httpd.apache.org\/docs\/2.4\/\n   Main PID: 661 (apache2)\n      Tasks: 10 (limit: 4644)\n     Memory: 29.6M\n        CPU: 9.372s\n     CGroup: \/system.slice\/apache2.service<\/code><\/pre>\n\n\n\n
\u00c9tape 3. Installer NodeJS<\/mark><\/h2>\n\n\n\n
Pour installer NodeJS, ex\u00e9cutez la commande suivante :<\/p>\n\n\n\n
sudo apt install nodejs -y<\/mark><\/pre>\n\n\n\n
Pour v\u00e9rifier la version de NodeJS install\u00e9e, ex\u00e9cutez la commande suivante :<\/p>\n\n\n\n
node -v<\/mark><\/pre>\n\n\n\n
root@host:~# node -v\nv18.13.0<\/code><\/pre>\n\n\n\n
Apr\u00e8s l’installation r\u00e9ussie de NodeJS, nous devons \u00e9galement installer NPM :<\/p>\n\n\n\n
sudo apt install npm -y<\/mark><\/pre>\n\n\n\n
Pour v\u00e9rifier la version NPM install\u00e9e, ex\u00e9cutez la commande suivante :<\/p>\n\n\n\n
npm -v
<\/mark><\/pre>\n\n\n\n
root@host:~# npm -v\n9.2.0<\/code><\/pre>\n\n\n\n
\u00c9tape 4. Installer Uptime Kuma<\/h2>\n\n\n\n
Maintenant que tous les logiciels requis sont install\u00e9s, nous pouvons commencer l’installation d’Uptime Kuma. Nous devons d’abord cloner le d\u00e9p\u00f4t Uptime Kuma depuis GitHub :<\/p>\n\n\n\n
cd \/opt

git clone https:\/\/github.com\/louislam\/uptime-kuma.git<\/mark><\/pre>\n\n\n\n
Vous devez pr\u00e9voir un certain temps pour que le d\u00e9p\u00f4t soit clon\u00e9 dans le r\u00e9pertoire \/opt<\/strong> :<\/p>\n\n\n\n
Cloning into 'uptime-kuma'...\nremote: Enumerating objects: 28276, done.\nremote: Counting objects: 100% (5082\/5082), done.\nremote: Compressing objects: 100% (446\/446), done.\nremote: Total 28276 (delta 4745), reused 4771 (delta 4619), pack-reused 23194\nReceiving objects: 100% (28276\/28276), 21.69 MiB | 5.30 MiB\/s, done.\nResolving deltas: 100% (21463\/21463), done.<\/code><\/pre>\n\n\n\n
Une fois t\u00e9l\u00e9charg\u00e9, allez dans le r\u00e9pertoire uptime-kuma<\/strong> et installez le gestionnaire de processus de production pm2<\/strong> :<\/p>\n\n\n\n
sudo npm install pm2 -g<\/mark><\/pre>\n\n\n\n
Apr\u00e8s cela, ex\u00e9cutez la commande suivante pour la configuration :<\/p>\n\n\n\n
npm run setup<\/mark><\/pre>\n\n\n\n
Une fois install\u00e9, d\u00e9marrez le serveur Uptime Kuma<\/strong> avec la commande suivante :<\/p>\n\n\n\n
pm2 start server\/server.js --name uptime-kuma<\/mark><\/pre>\n\n\n\n
Une fois d\u00e9marr\u00e9, vous devriez obtenir le r\u00e9sultat suivant :<\/p>\n\n\n\n
[PM2] G\u00e9n\u00e9ration du d\u00e9mon PM2 avec pm2_home=\/root\/.pm2
[PM2] PM2 d\u00e9monis\u00e9 avec succ\u00e8s
[PM2] D\u00e9marrage de \/opt\/uptime-kuma\/server\/server.js en fork_mode (1 instance)
[PM2] Termin\u00e9.
\u2502 id \u2502 nom \u2502 espace de noms \u2502 version \u2502 mode \u2502 pid \u2502 uptime \u2502 \u21ba \u2502 statut \u2502 cpu \u2502 m\u00e9moire \u2502 utilisateur
\u2502 0 \u2502 uptime-kuma \u2502 par d\u00e9faut \u2502 1.23.2 \u2502 fork \u2502 17161 \u2502 0s \u2502 0 \u2502 en ligne \u2502 0% \u2502 42,3 Mo\u2502 racine

<\/code><\/pre>\n\n\n\n
Apr\u00e8s cela, nous devons activer le service pm2<\/strong> pour d\u00e9marrer au d\u00e9marrage du syst\u00e8me avec la commande suivante :<\/p>\n\n\n\n
pm2 startup<\/mark><\/pre>\n\n\n\n
Vous devriez obtenir le r\u00e9sultat suivant :<\/p>\n\n\n\n
[PM2] Writing init configuration in \/etc\/systemd\/system\/pm2-root.service\n[PM2] Making script booting at startup...\n[PM2] [-] Executing: systemctl enable pm2-root...\nCreated symlink \/etc\/systemd\/system\/multi-user.target.wants\/pm2-root.service \u2192 \/etc\/systemd\/system\/pm2-root.service.\n[PM2] [v] Command successfully executed.\n+---------------------------------------+\n[PM2] Freeze a process list on reboot via:\n$ pm2 save\n\n[PM2] Remove init script via:\n$ pm2 unstartup systemd\n<\/code><\/pre>\n\n\n\n
Une fois l’installation termin\u00e9e, vous pouvez acc\u00e9der \u00e0 l’instance Uptime Kuma \u00e0 l’adresse http:\/\/YourServerIPAddress:3001<\/strong> . N’oubliez pas que vous devrez ajouter le num\u00e9ro de port 3001 \u00e0 la fin de votre URL pour acc\u00e9der au service.<\/p>\n\n\n\n
\u00c9tape 5. Configurer Apache comme proxy inverse<\/mark><\/h2>\n\n\n\n
Lorsqu’Uptime Kuma est install\u00e9, il n’est pas pratique d’utiliser son num\u00e9ro de port pour acc\u00e9der au service. Pour r\u00e9soudre ce probl\u00e8me, nous utiliserons Apache comme interface, qui se placera entre le visiteur et l’instance Uptime Kuma. Cela peut \u00e9galement renforcer la s\u00e9curit\u00e9 de votre instance Uptime Kuma en limitant l’acc\u00e8s via Apache.<\/p>\n\n\n\n
Si vous ne l’avez pas encore install\u00e9, vous pouvez installer Apache avec apt install apache2<\/strong> . Acc\u00e9dez au r\u00e9pertoire de configuration d’Apache et cr\u00e9ez un fichier de configuration pour l’instance Uptime Kuma.<\/p>\n\n\n\n
cd \/etc\/apache2\/sites-available\/<\/mark>

nano kuma.conf<\/mark><\/pre>\n\n\n\n
Ouvrez le fichier, collez les lignes de code suivantes, enregistrez-le et fermez-le. Assurez-vous de remplacer votredomaine.com<\/strong> par le nom de domaine que vous souhaitez utiliser pour acc\u00e9der \u00e0 l’instance Kuma.<\/p>\n\n\n\n
<VirtualHost *:80>\nServerName yourdomain.com\nDocumentRoot \/var\/www\/html\/\n\nProxyPass \/ http:\/\/localhost:3001\/\nRewriteEngine on\nRewriteCond %{HTTP:Upgrade} websocket [NC]\nRewriteCond %{HTTP:Connection} upgrade [NC]\nRewriteRule ^\/?(.*) \"ws:\/\/localhost:3001\/$1\" [P,L]\n\nErrorLog ${APACHE_LOG_DIR}\/error.log\nCustomLog ${APACHE_LOG_DIR}\/access.log combined\n\n<\/VirtualHost><\/code><\/pre>\n\n\n\n
Activez la configuration Apache pour Kuma et activez les modules rewrite<\/strong> , proxy<\/strong> et proxy_http<\/strong> d’Apache .<\/p>\n\n\n\n
a2dissite 000-default.conf

sudo a2enmod rewrite

sudo a2enmod proxy

sudo a2enmod proxy_http

sudo a2ensite kuma.conf<\/mark><\/pre>\n\n\n\n
V\u00e9rifiez la syntaxe :<\/p>\n\n\n\n
apachectl -t<\/mark><\/pre>\n\n\n\n
Vous devriez recevoir le r\u00e9sultat suivant :<\/p>\n\n\n\n
root@vps:~# apachectl -t\nSyntaxe OK<\/code><\/pre>\n\n\n\n
Si la syntaxe est correcte, red\u00e9marrez le service Apache.<\/p>\n\n\n\n
systemctl restart apache2<\/mark><\/pre>\n\n\n\n
\u00c9tape 6. Terminer l’installation d’Uptime Kuma<\/mark><\/h2>\n\n\n\n
Si tout est correctement configur\u00e9, vous pourrez acc\u00e9der \u00e0 l’instance Uptime Kuma \u00e0 l’adresse http:\/\/YourDomainName<\/strong> .<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
\u00c9tape 7. Installation du certificat SSL Let’s Encrypt<\/mark><\/h2>\n\n\n\n
sudo apt install certbot

sudo apt install python3-certbot-apache<\/mark>

sudo certbot --apache -d nom-de-domaine.com<\/mark><\/pre>\n\n\n\n
Remplacez nom-de-domaine.com<\/mark><\/strong> par celui que vous poss\u00e9dez.<\/p>\n\n\n\n
Pour terminer la mise en place du certificat SSL, \u00e9ditez votre VitualHost kuma.conf<\/mark> :<\/p>\n\n\n\n
<VirtualHost *:80>\n        ServerName nom-de-domaine.com<\/mark><\/strong>\n        DocumentRoot \/var\/www\/html\/\n\n        ProxyPass \/ http:\/\/localhost:3001\/\n        RewriteEngine on\n        RewriteCond %{HTTP:Upgrade} websocket [NC]\n        RewriteCond %{HTTP:Connection} upgrade [NC]\n        RewriteRule ^\/?(.*) \"ws:\/\/localhost:3001\/$1\" [P,L]\n\n        ErrorLog ${APACHE_LOG_DIR}\/error.log\n        CustomLog ${APACHE_LOG_DIR}\/access.log combined\n\n        RewriteCond %{SERVER_NAME} =nom-de-domaine.com<\/mark><\/strong> [OR]\n        RewriteCond %{SERVER_NAME} =yourdomain.com\n        RewriteRule ^ https:\/\/%{SERVER_NAME}%{REQUEST_URI} [END,NE,R=permanent]\n\n<\/VirtualHost>\n\n<VirtualHost *:443>\n        ServerName nom-de-domaine.com<\/mark><\/strong>\n        SSLEngine On\n        SSLCertificateFile \/etc\/letsencrypt\/live\/nom-de-domaine.com<\/mark><\/strong>\/fullchain.pem\n        SSLCertificateKeyFile \/etc\/letsencrypt\/live\/nom-de-domaine.com<\/mark><\/strong>\/privkey.pem\n        # Protocol 'h2' is only supported on Apache 2.4.17 or newer.<\/mark>\n        Protocols h2 http\/1.1\n        ProxyPreserveHost on\n        ProxyPass \/ http:\/\/localhost:3001\/\n        RewriteEngine on\n        RewriteCond %{HTTP:Upgrade} =websocket\n        RewriteRule \/(.*) ws:\/\/localhost:3001\/$1 [P,L]\n        RewriteCond %{HTTP:Upgrade} !=websocket\n        RewriteRule \/(.*) http:\/\/localhost:3001\/$1 [P,L]\n\n<\/VirtualHost>\n<\/code><\/pre>\n\n\n\n
Autres configuration SSL possible : https:\/\/github.com\/louislam\/uptime-kuma\/wiki\/Reverse-Proxy<\/a><\/p>\n\n\n\n
Guide de configuration Uptime-Kuma : https:\/\/betterstack.com\/community\/guides\/monitoring\/uptime-kuma-guide\/<\/a><\/p>\n\n\n\n
\u00c9tape 8. Configuration notification SMTP<\/mark><\/h2>\n\n\n\n
\"\"<\/figure>\n\n\n\n
(Astuce) En cas d’arr\u00eat du service PM2 :<\/h3>\n\n\n\n
Placez vous dans le r\u00e9pertoire uptime-kuma : <\/p>\n\n\n\n
cd \/opt\/uptime-kuma<\/mark>

pm2 start server\/server.js --name uptime-kuma<\/mark><\/pre>\n\n\n\n
\"\"<\/figure>\n\n\n\n
PM2 : Liste de commandes<\/h2>\n\n\n\n
Source : https:\/\/pm2.keymetrics.io\/docs\/usage\/quick-start\/<\/a><\/p>\n\n\n\n
# Fork mode\npm2 start app.js --name my-api # Name process\n\n# Cluster mode\npm2 start app.js -i 0        # Will start maximum processes with LB depending on available CPUs\npm2 start app.js -i max      # Same as above, but deprecated.\npm2 scale app +3             # Scales `app` up by 3 workers\npm2 scale app 2              # Scales `app` up or down to 2 workers total\n\n# Listing\n\npm2 list               # Display all processes status\npm2 jlist              # Print process list in raw JSON\npm2 prettylist         # Print process list in beautified JSON\n\npm2 describe 0         # Display all information about a specific process\n\npm2 monit              # Monitor all processes\n\n# Logs\n\npm2 logs [--raw]       # Display all processes logs in streaming\npm2 flush              # Empty all log files\npm2 reloadLogs         # Reload all logs\n\n# Actions\n\npm2 stop all           # Stop all processes\npm2 restart all        # Restart all processes\n\npm2 reload all         # Will 0s downtime reload (for NETWORKED apps)\n\npm2 stop 0             # Stop specific process id\npm2 restart 0          # Restart specific process id\n\npm2 delete 0           # Will remove process from pm2 list\npm2 delete all         # Will remove all processes from pm2 list\n\n# Misc\n\npm2 reset <process>    # Reset meta data (restarted time...)\npm2 updatePM2          # Update in memory pm2\npm2 ping               # Ensure pm2 daemon has been launched\npm2 sendSignal SIGUSR2 my-app # Send system signal to script\npm2 start app.js --no-daemon\npm2 start app.js --no-vizion\npm2 start app.js --no-autorestart<\/code><\/pre>\n\n\n\n
<\/p>\n","protected":false},"excerpt":{"rendered":"
Dans ce tutoriel, nous allons expliquer \u00e9tape par \u00e9tape comment installer Uptime Kuma sur Debian 12. Uptime Kuma<\/p>\n","protected":false},"author":1,"featured_media":3416,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[3],"tags":[],"class_list":["post-3366","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-linux"],"_links":{"self":[{"href":"https:\/\/hinakuu.xyz\/index.php?rest_route=\/wp\/v2\/posts\/3366","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/hinakuu.xyz\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/hinakuu.xyz\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/hinakuu.xyz\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/hinakuu.xyz\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=3366"}],"version-history":[{"count":39,"href":"https:\/\/hinakuu.xyz\/index.php?rest_route=\/wp\/v2\/posts\/3366\/revisions"}],"predecessor-version":[{"id":3535,"href":"https:\/\/hinakuu.xyz\/index.php?rest_route=\/wp\/v2\/posts\/3366\/revisions\/3535"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/hinakuu.xyz\/index.php?rest_route=\/wp\/v2\/media\/3416"}],"wp:attachment":[{"href":"https:\/\/hinakuu.xyz\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=3366"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/hinakuu.xyz\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=3366"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/hinakuu.xyz\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=3366"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}