Hostati Uptime Kuma na Managed VPS-u: nadzirite svoje usluge neprekidno

Što nadzire Uptime Kuma

Uptime Kuma u redovitim razmacima, do svakih 20 sekundi, provjerava vaše usluge, čuva povijest njihovih odgovora i javlja vam čim jedna od njih prestane odgovarati. Koristi se preko web-sučelja, dostupnog na više jezika.

• Provjere: HTTP i HTTPS, traženje ključne riječi na stranici, JSON zahtjev, TCP, WebSocket, ping, DNS zapis, Docker kontejneri te „push” provjera za planirani zadatak koji sam javlja da je pokrenut.
• Upozorenja: više od 90 usluga za obavijesti, među kojima Telegram, Discord, Slack i e-pošta.
• Statusne stranice: više javnih stranica, svaka po želji na vlastitoj domeni.
• Certifikati: podaci o HTTPS certifikatu svake nadzirane usluge.
• Račun: dvofaktorska autentifikacija i prolaz kroz proxy za provjere kojima je potreban.

Uptime Kuma postavite na drugi poslužitelj, a ne onaj s uslugama koje nadzire. Na zasebnom stroju vidi kvar izvana i šalje upozorenje dok su vaše usluge zaustavljene.

Što dopušta licenca MIT

Uptime Kuma objavljen je pod licencom MIT. Ona dopušta upotrebu, kopiranje, izmjenu, spajanje, objavljivanje, distribuciju, podlicenciranje i prodaju softvera, uz jedan uvjet: napomena o autorskim pravima i tekst licence moraju ostati u svakoj kopiji.

Uptime Kuma stoga možete pokretati u tvrtki, u njemu nadzirati usluge svojih klijenata i otvarati im statusne stranice, bez kupnje licence.

Instalacija s Docker Composeom

Dokumentacija Uptime Kuma počinje s Docker Composeom. Na poslužitelju s instaliranim Dockerom izradite mapu i preuzmite službenu datoteku:

mkdir uptime-kuma
cd uptime-kuma
curl -o compose.yaml https://raw.githubusercontent.com/louislam/uptime-kuma/master/compose.yaml

Datoteka projekta objavljuje port 3001 na svim adresama poslužitelja. Iza obrnutog proxyja ograničite ga na lokalnu adresu, kako predlaže README:

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

• Port objavljen na 127.0.0.1: Docker prema zadanim postavkama objavljuje portove na svim adresama poslužitelja, prije pravila vatrozida ufw. Lokalno je Uptime Kuma dostupan samo preko obrnutog proxyja.
• Mapa data na lokalnom disku: čuva bazu kuma.db, poslane datoteke i snimke zaslona. Projekt isključuje NFS i druge mrežne datotečne sustave, jer SQLite treba pouzdana zaključavanja datoteka.
• Oznaka 2 prati inačicu 2 programa Uptime Kuma, a prelazak na sljedeću glavnu inačicu ostaje vaša odluka.
• Slika 2-slim je lakša, oko 185 MB za preuzimanje naspram 620 MB: izostavlja Chromium i ugrađeni MariaDB koje nosi slika 2. Slika 2 je ona koju projekt preporučuje, a provjera „Browser Engine” uz 2-slim traži vanjski Chromium.

Pri prvom pokretanju otvorite sučelje: čarobnjak vas traži da odaberete bazu podataka, a zatim da izradite administratorski račun. Dvofaktorsku autentifikaciju uključite već pri prvoj prijavi.

Projekt ne navodi potrebnu memoriju ni procesor: veličina ovisi o broju usluga koje nadzirete i željenoj učestalosti provjera. Na Managed VPS-u opišite nam svoju upotrebu, a mi vam preporučujemo odgovarajuću veličinu.

HTTPS i WebSocket: obrnuti proxy

Na javnoj mreži projekt traži HTTPS. Uptime Kuma temelji se na WebSocketu: obrnuti proxy mora prosljeđivati zaglavlja Upgrade i Connection. Poslužuje se u korijenu domene ili poddomene, a njegov wiki isključuje podmape poput example.com/uptimekuma.

S Caddyjem

Caddy sam pribavlja i obnavlja certifikat te prosljeđuje WebSocket bez dodatnih postavki:

uptime.example.com {
    reverse_proxy 127.0.0.1:3001
}

S Nginxom i Certbotom

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 zatim postavlja certifikat Let’s Encrypt i preusmjeravanje na HTTPS te sam obnavlja certifikat:

sudo certbot --nginx -d uptime.example.com

Kada je Uptime Kuma dostupan samo preko proxyja, otvorite njegove postavke, „Settings”, „Reverse Proxy”, „HTTP Headers”, i „Trust Proxy” postavite na „Yes”: zapisnici tada prikazuju stvarnu adresu posjetitelja.

SQLite ili MariaDB

Od inačice 2 Uptime Kuma nudi tri baze, koje birate u čarobnjaku pri prvom pokretanju:

Da biste izbor unaprijed odredili, bez čarobnjaka, varijable UPTIME_KUMA_DB_TYPE, UPTIME_KUMA_DB_HOSTNAME, UPTIME_KUMA_DB_PORT, UPTIME_KUMA_DB_NAME, UPTIME_KUMA_DB_USERNAME i UPTIME_KUMA_DB_PASSWORD dodaju se usluzi u datoteci compose.yaml.

Obavijesti, uključujući e-poštu

Provjera vrijedi samo ako upozorenje stigne do vas. Svoje kanale navedite u „Settings”, „Notifications”, sa svakog pošaljite probnu poruku i predvidite dva, na primjer aplikaciju za poruke i e-poštu: ako jedan zakaže, drugi preuzima.

Za e-poštu se Uptime Kuma spaja na SMTP poslužitelj. Na Simafri VPS-u slanje ide preko autentificiranog releja, na portu 587: adresa računa e-pošte koji već imate ili Simafri Suite.

Sigurnosne kopije i ažuriranja

Od inačice 2 sigurnosna kopija mape data jedina je metoda koju projekt podržava. Uz SQLite ili ugrađeni MariaDB, sve je u njoj. SQLite baza kopirana usred pisanja može ostati oštećena: zaustavite kontejner za vrijeme kopiranja, imajući na umu da se s njim zaustavljaju i provjere.

docker compose stop
tar -czf uptime-kuma-$(date +%F).tar.gz data
docker compose start

Ažuriranje

Wiki projekta daje dvije naredbe, iz mape s datotekom compose.yaml. Mapa data ostaje na mjestu:

docker compose pull
docker compose up -d --force-recreate

Prije svakog ažuriranja pročitajte bilješke o izdanju: neka sadrže sigurnosne ispravke, poput inačice 2.5.9 od 31. listopada 2026. Sigurnosna kopija neposredno prije omogućuje jednostavan povratak.

Prelazak s inačice 1 na inačicu 2 traži više pažnje: sigurnosno kopirajte mapu data dok je kontejner zaustavljen i pustite da se migracija završi, jer prekinuta migracija zahtijeva vraćanje sigurnosne kopije. Projekt je izmjerio otprilike 7 minuta za 20 provjera i 90 dana povijesti, a znatno više na skromnom stroju ili s više provjera.

Tko što radi na Managed VPS-u

Hostanje na vlastitom poslužitelju traži da uz aplikaciju održavate i poslužitelj. Na Managed VPS-u naši timovi preuzimaju poslužitelj i proaktivno prate vašu instancu; Uptime Kuma ostaje vaš softver, sa svojim postavkama i podacima.

Ako želite da naši timovi interveniraju u samoj aplikaciji, ta se usluga naplaćuje po satu ili paušalno, uz procjenu koja vam se priopćuje prije intervencije.