Uptime Kuma op engem Managed VPS hosten heescht, Är Websäiten, Är APIen an Är Server vun enger Maschinn aus ze iwwerwaachen, déi Iech gehéiert a vun eisen Equippe Dag an Nuecht aktuell gehal a verfollegt gëtt. Uptime Kuma ass eng fräi Software ënner der MIT-Lizenz. Dëse Guide follegt senger offizieller Dokumentatioun: d’Installatioun mat Docker Compose, HTTPS, d’Datebank, d’Notifikatiounen, d’Backups an d’Aktualiséierungen.
Auteur: Simon Vasconcelos Lee
Publizéiert de 4. November 2026Lieszäit: 7 Minutten
data op engem lokalen Disk.data bei gestoppte Container, an aktualiséiert mat docker compose pull.Uptime Kuma frot Är Servicer a regelméissegen Ofstänn of, bis alle 20 Sekonnen, hält de Verlaf vun hiren Äntwerten a mellt Iech, soubal ee vun hinnen net méi äntwert. Et gëtt iwwer eng Webinterface benotzt, déi a verschiddene Sprooche verfügbar ass.
Setzt Uptime Kuma op en anere Server wéi d’Servicer, déi en iwwerwaacht. Op enger separater Maschinn gesäit en d’Panne vu baussen a schéckt d’Alert, wärend Är Servicer gestoppt sinn.
Uptime Kuma gëtt ënner der MIT-Lizenz publizéiert. Si erlaabt, d’Software ze notzen, ze kopéieren, z’änneren, ze fusionéieren, ze publizéieren, weiderzeginn, ënner Ënnerlizenz ze setzen an ze verkafen, ënner enger eenzeger Bedingung: de Copyright-Hiweis an den Text vun der Lizenz an all Kopie ze behalen.
Dir kënnt Uptime Kuma also an Ärer Entreprise lafe loossen, d’Servicer vun Äre Clienten doranner iwwerwaachen an hinnen Statussäite opmaachen, ouni eng Lizenz ze kafen.
D’Dokumentatioun vun Uptime Kuma fänkt mat Docker Compose un. Op engem Server, wou Docker installéiert ass, erstellt Dir en Dossier a luet den offizielle Fichier erof:
mkdir uptime-kuma
cd uptime-kuma
curl -o compose.yaml https://raw.githubusercontent.com/louislam/uptime-kuma/master/compose.yaml
De Fichier vum Projet publizéiert de Port 3001 op all Adresse vum Server. Hannert engem Reverse Proxy beschränkt en op déi lokal Adress, wéi et de README virschléit:
services:
uptime-kuma:
image: louislam/uptime-kuma:2
restart: unless-stopped
volumes:
- ./data:/app/data
ports:
- "127.0.0.1:3001:3001"
docker compose up -d
127.0.0.1 publizéiert ass: Docker publizéiert standardméisseg op all Adresse vum Server, virun de Reegele vun der Firewall ufw. Lokal gebonnen, ass Uptime Kuma nëmmen iwwer de Reverse Proxy z’erreechen.data op engem lokalen Disk: en hält d’Datebank kuma.db, déi eropgelueden Fichieren an d’Screenshots. De Projet schléisst NFS an déi aner Netzwierk-Dateisystemer aus, well SQLite zouverlässeg Fichier-Spären brauch.2 follegt der Versioun 2 vun Uptime Kuma, an de Wiessel op eng nächst Major-Versioun bleift Är Entscheedung.2-slim ass méi liicht, ongeféier 185 MB erofzelueden amplaz 620 MB: si léisst Chromium an de integréierte MariaDB eraus, déi d’Image 2 mathëlt. D’Image 2 ass déi, déi de Projet recommandéiert, an e „Browser Engine“-Monitor brauch mat 2-slim e Chromium vu baussen.Beim éischte Start maacht d’Interface op: en Assistent léisst Iech d’Datebank wielen an dann den Administrateur-Kont erstellen. Aktivéiert d’Zwee-Faktor-Authentifiséierung vun der éischter Verbindung un.
De Projet gëtt weder Aarbechtsspäicher nach Prozessor un: d’Gréisst hänkt vun der Zuel vun de Servicer of, déi iwwerwaacht ginn, an der gewënschter Frequenz. Op engem Managed VPS beschreift eis Äre Gebrauch, a mir recommandéieren Iech déi passend Gréisst.
Op engem ëffentlechen Netz verlaangt de Projet HTTPS. Uptime Kuma baséiert op WebSocket: de Reverse Proxy muss d’Header Upgrade an Connection weiderginn. Et gëtt op der Wuerzel vun enger Domain oder Subdomain servéiert, a säi Wiki schléisst Ënnerdossiere wéi example.com/uptimekuma aus.
Caddy hëlt d’Zertifikat selwer an erneiert et, a gëtt WebSocket ouni zousätzlech Astellung weider:
uptime.example.com {
reverse_proxy 127.0.0.1:3001
}
server {
listen 80;
server_name uptime.example.com;
location / {
proxy_pass http://localhost:3001;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header Host $host;
}
}
Certbot setzt duerno d’Zertifikat vu Let’s Encrypt an d’Viruleedung op HTTPS, an erneiert d’Zertifikat dono vu sech aus:
sudo certbot --nginx -d uptime.example.com
Wann Uptime Kuma nëmmen iwwer de Proxy z’erreechen ass, mécht seng Astellungen op, „Settings“, „Reverse Proxy“, „HTTP Headers“, a stellt „Trust Proxy“ op „Yes“: d’Logbicher weisen dann déi richteg Adress vun de Besucher.
Zënter senger Versioun 2 bitt Uptime Kuma dräi Datebanken, no Wiel am Assistent vum éischte Start:
| Datebank | Ariichten | Backup |
|---|---|---|
| SQLite | Keng: ee Fichier, data/kuma.db | Kopie vum Dossier data, bei gestoppte Container |
| Integréierte MariaDB | Keng: mat der Image 2 geliwwert | Kopie vum Dossier data, bei gestoppte Container |
| Externe MariaDB | Äre MariaDB-Server, a seng Zougäng | Export vun der Datebank, zousätzlech zum Dossier data |
Fir d’Wiel am Viraus festzeleeën, ouni den Assistent, ginn d’Variabelen UPTIME_KUMA_DB_TYPE, UPTIME_KUMA_DB_HOSTNAME, UPTIME_KUMA_DB_PORT, UPTIME_KUMA_DB_NAME, UPTIME_KUMA_DB_USERNAME an UPTIME_KUMA_DB_PASSWORD am Service an der compose.yaml dobäi.
E Monitor ass nëmme nëtzlech, wann d’Alert bei Iech ukënnt. Deklaréiert Är Kanäl ënner „Settings“, „Notifications“, schéckt vun all engem eng Testnoriicht, a plangt der zwee, zum Beispill eng Messagerie an d’E-Mail: wann een ausfält, iwwerhëlt deen aneren.
Fir d’E-Mail verbënnt sech Uptime Kuma mat engem SMTP-Server. Op engem Simafri-VPS geet de Versand iwwer e authentifizéierte Relais, um Port 587: d’Adress vun engem E-Mail-Kont, deen Dir schonn hutt, oder Simafri Suite.
Zënter der Versioun 2 ass d’Backup vum Dossier data deen eenzege Wee, deen de Projet ënnerstëtzt. Mat SQLite oder dem integréierte MariaDB steet alles do dran. Eng SQLite-Datebank, déi mëttendrun am Schreiwen kopéiert gëtt, kann beschiedegt ginn: stoppt de Container fir d’Zäit vun der Kopie, a wësst, datt d’Monitoren domat stoppen.
docker compose stop
tar -czf uptime-kuma-$(date +%F).tar.gz data
docker compose start
De Wiki vum Projet gëtt zwee Befeeler, aus dem Dossier vun der compose.yaml. Den Dossier data bleift op senger Plaz:
docker compose pull
docker compose up -d --force-recreate
Liest d’Release Notes virun all Aktualiséierung: e puer enthalen Sécherheetskorrekturen, wéi d’2.5.9 vum 31. Oktober 2026. Eng Backup direkt virdrun gëtt Iech eng einfach Méiglechkeet, zeréckzegoen.
De Wiessel vun der Versioun 1 op d’Versioun 2 verlaangt méi Suergfalt: séchert den Dossier data bei gestoppte Container, a loosst d’Migratioun bis zum Enn lafen, well eng ënnerbrach Migratioun d’Restauratioun vun der Backup erfuerdert. De Projet huet ongeféier 7 Minutte fir 20 Monitoren an 90 Deeg Geschicht gemooss, a vill méi op enger bescheidener Maschinn oder mat méi Monitoren.
Selwer hosten heescht, de Server zousätzlech zur Applikatioun ze halen. Op engem Managed VPS huelen eis Equippen de Server an d’Hand a verfollegen Är Instanz proaktiv; Uptime Kuma bleift Är Software, mat senge Astellungen an Donnéeën.
| Thema | Eis Equippen | Dir |
|---|---|---|
| De Server | System- a Sécherheetsupdates, Interventioune um Server abegraff | De Moment, deen zu Ärer Aktivitéit passt |
| D’Iwwerwaachung | Server 24 Stonnen op 24 a 7 Deeg op 7 verfollegt, mat Interventioun, ouni op Ären Uruff ze waarden | D’Monitoren an d’Alerte vun Ären eegene Servicer |
| Uptime Kuma | Proaktiv Suivi: Feeler, lues Äntwertzäiten a Späicherplaz erkannt, Korrektur recommandéiert | Seng Installatioun, seng Aktualiséierungen a seng Astellungen, déi Dir ëmsetzt, selwer oder mat Ärem KI-Assistent |
| D’Backups | All Nuecht, verschlësselt a baussent der Maschinn gelagert; Restauratioun abegraff | D’Ufro fir eng Restauratioun, wann Dir se braucht |
| D’Migratioun | Äre bestoende Server migréiert, offréiert | De Moment vum Wiessel |
Wann Dir léiwer wëllt, datt eis Equippen an der Applikatioun selwer intervenéieren, gëtt dës Prestatioun op Stonnebasis oder pauschal verrechent, mat engem Käschtevirschlag, deen Iech virun der Interventioun matgedeelt gëtt.
Mat engem Managed VPS vu Simafri halen eis Equippen de Server vun Ärer Uptime-Kuma-Instanz aktuell, iwwerwaachen en Dag an Nuecht a gräifen an, ouni op Ären Uruff ze waarden; si verfollegen och Är Instanz proaktiv a recommandéieren Iech déi nëtzlech Korrekturen, déi Dir ëmsetzt, selwer oder mat Ärem KI-Assistent. D’Backups ginn all Nuecht verschlësselt a baussent der Maschinn gelagert, hir Restauratioun ass abegraff, an d’Migratioun vun Ärem aktuelle Server ass offréiert.
Jo. Uptime Kuma ass ënner der MIT-Lizenz: Dir kënnt en an der Entreprise notzen, d’Servicer vun Äre Clienten doranner iwwerwaachen an hinnen Statussäite opmaachen, wann Dir säi Lizenzhiweis behaalt. Et bleiwen d’Käschte vum Server, deen en hält.
Erstellt en Dossier, luet de Fichier compose.yaml vum Projet erof, a lancéiert dann docker compose up -d. D’Interface äntwert um Port 3001, wou en Assistent Iech d’Datebank léisst wielen an den Administrateur-Kont erstellen.
Et funktionéiert esou, awer eng Panne vun der Maschinn géif de Site a seng Alert zur selwechter Zäit stoppen. Setzt Uptime Kuma op en anere Server wéi d’Servicer, déi en iwwerwaacht: en gesäit d’Panne vu baussen a mellt se Iech.
Uptime Kuma baséiert op WebSocket: de Proxy muss d’Header Upgrade an Connection weiderginn, wat Caddy vu sech aus mécht. Servéiert en op der Wuerzel vun enger Domain oder Subdomain, a stellt dann Trust Proxy an den Astellungen op Yes.
SQLite, déi einfachst, passt an e Fichier vum Dossier data. D’Versioun 2 bitt och e MariaDB, dee mat der Image 2 integréiert ass, oder Äre eegene MariaDB-Server. D’Wiel gëtt am Assistent vum éischte Start gemaach.
Aus dem Dossier vun der compose.yaml lancéiert docker compose exec uptime-kuma npm run reset-password, a follegt dann de Froen. D’Skript remove-2fa hëlt op déiselwecht Manéier d’Zwee-Faktor-Authentifiséierung ewech, wann Dir de Zougang derzou verluer hutt.
E Managed VPS deckt de Server of: System, Sécherheet, Iwwerwaachung a Backups. Eis Equippen verfollegen och Är Instanz proaktiv a recommandéieren Iech déi nëtzlech Korrekturen, déi Dir ëmsetzt. Eng Interventioun an der Applikatioun gëtt op Stonnebasis oder pauschal verrechent.
Simafri
Loosst eis iwwer Är Websäit schwätzen
Erzielt eis vun Ärem Projet a wéinege Wierder: mir mellen eis séier bei Iech.
Merci! Är Ufro gouf geschéckt. Mir mellen eis séier bei Iech.
Léiwer per E-Mail? Schreift eis op support@simafri.com.