Näin hostaatte Uptime Kuman Managed VPS:llä: valvokaa palveluitanne jatkuvasti

Mitä Uptime Kuma valvoo

Uptime Kuma kysyy palveluiltanne säännöllisin väliajoin, aina 20 sekunnin välein asti, säilyttää niiden vastausten historian ja ilmoittaa heti, kun jokin niistä lakkaa vastaamasta. Sitä käytetään verkkokäyttöliittymästä, joka on saatavilla useilla kielillä.

• Anturit: HTTP ja HTTPS, avainsanan etsintä sivulta, JSON-kysely, TCP, WebSocket, ping, DNS-tietue, Docker-kontit sekä ”push”-anturi ajastetulle tehtävälle, joka ilmoittaa itse suorituksestaan.
• Hälytykset: yli 90 ilmoituspalvelua, muun muassa Telegram, Discord, Slack ja sähköposti.
• Tilasivut: useita julkisia sivuja, joista jokaisella voi halutessanne olla oma verkkotunnuksensa.
• Varmenteet: kunkin valvotun palvelun HTTPS-varmenteen tiedot.
• Tili: kaksivaiheinen tunnistautuminen sekä välityspalvelimen käyttö antureille, jotka sitä tarvitsevat.

Sijoittakaa Uptime Kuma eri palvelimelle kuin valvomanne palvelut. Erillisellä koneella se näkee vian ulkopuolelta ja lähettää hälytyksen palveluidenne ollessa pysähtyneinä.

Mitä MIT-lisenssi sallii

Uptime Kuma julkaistaan MIT-lisenssillä. Se sallii ohjelman käyttämisen, kopioimisen, muokkaamisen, yhdistämisen, julkaisemisen, jakelun, alilisensoinnin ja myymisen yhdellä ehdolla: tekijänoikeusmerkintä ja lisenssin teksti säilytetään jokaisessa kopiossa.

Voitte siis ajaa Uptime Kumaa yrityksessä, valvoa sillä asiakkaidenne palveluita ja avata heille tilasivuja ilman ostettavaa lisenssiä.

Asennus Docker Composella

Uptime Kuman dokumentaatio aloittaa Docker Composesta. Luokaa palvelimelle, jolle Docker on asennettu, kansio ja noutakaa virallinen tiedosto:

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

Projektin tiedosto julkaisee portin 3001 palvelimen kaikissa osoitteissa. Käänteisen välityspalvelimen takana rajatkaa se paikalliseen osoitteeseen, kuten README ehdottaa:

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

• Portti julkaistaan osoitteessa 127.0.0.1: Docker julkaisee oletuksena palvelimen kaikissa osoitteissa, ennen ufw-palomuurin sääntöjä. Paikallisena Uptime Kumaan pääsee vain käänteisen välityspalvelimen kautta.
• Paikallisella levyllä oleva data-kansio: se sisältää kuma.db-tietokannan, lähetetyt tiedostot ja kuvakaappaukset. Projekti sulkee pois NFS:n ja muut verkkotiedostojärjestelmät, koska SQLite tarvitsee luotettavat tiedostolukot.
• Tunniste 2 seuraa Uptime Kuman versiota 2, ja siirtyminen seuraavaan pääversioon jää teidän päätettäväksenne.
• Image 2-slim on kevyempi, noin 185 Mt ladattavaa 620 Mt:n sijaan: siitä puuttuvat Chromium ja sisäänrakennettu MariaDB, jotka image 2 sisältää. Image 2 on projektin suosittelema, ja ”Browser Engine” -anturi vaatii 2-slim-imagen kanssa ulkoisen Chromiumin.

Avatkaa käyttöliittymä ensimmäisellä käynnistyksellä: ohjattu toiminto antaa valita tietokannan ja luoda sitten ylläpitäjän tilin. Ottakaa kaksivaiheinen tunnistautuminen käyttöön heti ensimmäisellä kirjautumiskerralla.

Projekti ei ilmoita muistin eikä suorittimen tarvetta: koko riippuu valvottavien palveluiden määrästä ja haluamastanne tiheydestä. Managed VPS -palvelimella kertokaa meille käyttötarkoituksenne, niin suosittelemme sopivaa kokoa.

HTTPS ja WebSocket: käänteinen välityspalvelin

Julkisessa verkossa projekti vaatii HTTPS:n. Uptime Kuma perustuu WebSocketiin: käänteisen välityspalvelimen on välitettävä otsakkeet Upgrade ja Connection. Se tarjotaan verkkotunnuksen tai aliverkkotunnuksen juuressa, ja sen wiki sulkee pois alikansiot, kuten example.com/uptimekuma.

Caddyllä

Caddy hankkii ja uusii varmenteen itse ja välittää WebSocketin ilman lisäasetuksia:

uptime.example.com {
    reverse_proxy 127.0.0.1:3001
}

Nginxillä ja Certbotilla

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 asentaa sen jälkeen Let’s Encrypt -varmenteen ja uudelleenohjauksen HTTPS:ään ja uusii varmenteen sitten itse:

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

Kun Uptime Kumaan pääsee vain välityspalvelimen kautta, avatkaa sen asetukset, ”Settings”, ”Reverse Proxy”, ”HTTP Headers”, ja asettakaa ”Trust Proxy” arvoon ”Yes”: lokeihin tulee silloin kävijöiden todellinen osoite.

SQLite vai MariaDB

Versiosta 2 alkaen Uptime Kuma tarjoaa kolme tietokantaa, joista valitaan ensimmäisen käynnistyksen ohjatussa toiminnossa:

Valinnan voi lukita etukäteen ilman ohjattua toimintoa: muuttujat UPTIME_KUMA_DB_TYPE, UPTIME_KUMA_DB_HOSTNAME, UPTIME_KUMA_DB_PORT, UPTIME_KUMA_DB_NAME, UPTIME_KUMA_DB_USERNAME ja UPTIME_KUMA_DB_PASSWORD lisätään palveluun tiedostossa compose.yaml.

Ilmoitukset, sähköposti mukaan lukien

Anturista on hyötyä vain, jos hälytys tavoittaa teidät. Määritelkää kanavanne kohdassa ”Settings”, ”Notifications”, lähettäkää koeviesti jokaisesta ja varatkaa niitä kaksi, esimerkiksi pikaviestin ja sähköposti: jos toinen kaatuu, toinen ottaa vastuun.

Sähköpostia varten Uptime Kuma yhdistää SMTP-palvelimeen. Simafrin VPS:llä lähetys kulkee todennetun releen kautta portissa 587: käyttöön sopii jo omistamanne sähköpostitilin osoite tai Simafri Suite.

Varmuuskopiot ja päivitykset

Versiosta 2 alkaen data-kansion varmuuskopiointi on ainoa tapa, jota projekti tukee. SQLitellä tai sisäisellä MariaDB:llä kaikki on siellä. Kesken kirjoituksen kopioitu SQLite-tietokanta voi vioittua: pysäyttäkää kontti kopioinnin ajaksi, vaikka anturit pysähtyvät sen mukana.

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

Päivittäminen

Projektin wiki antaa kaksi komentoa, ajettavaksi compose.yaml-tiedoston kansiossa. data-kansio pysyy paikallaan:

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

Lukekaa julkaisutiedot ennen jokaista päivitystä: osa sisältää tietoturvakorjauksia, kuten 31. lokakuuta 2026 julkaistu 2.5.9. Juuri ennen otettu varmuuskopio antaa yksinkertaisen paluumahdollisuuden.

Siirtyminen versiosta 1 versioon 2 vaatii enemmän huolellisuutta: varmuuskopioikaa data-kansio kontti pysäytettynä ja antakaa migraation edetä loppuun, sillä keskeytynyt migraatio pakottaa palauttamaan varmuuskopion. Projekti on mitannut noin 7 minuuttia 20 anturille ja 90 päivän historialle, ja huomattavasti pidempään vaatimattomalla koneella tai useammalla anturilla.

Kuka tekee mitä Managed VPS:llä

Oma hostaus vaatii palvelimen ylläpitoa sovelluksen lisäksi. Managed VPS -palvelimella tiimimme huolehtivat palvelimesta ja seuraavat instanssianne proaktiivisesti; Uptime Kuma pysyy teidän ohjelmananne asetuksineen ja tietoineen.

Jos haluatte tiimiemme toimivan itse sovelluksessa, tämä palvelu laskutetaan tuntiveloituksella tai kiinteällä hinnalla, ja arvio annetaan ennen toimenpidettä.