Näin hostaatte Checkmaten Managed VPS:llä: valvonta omalla palvelimella

Checkmaten hostaus Managed VPS:llä tarkoittaa, että verkkosivustojenne ja palvelimienne valvonta pysyy koneella, joka on teidän ja jota tiimimme pitävät ajan tasalla ja valvovat yötä päivää. Checkmate on AGPL-3.0-lisenssillä julkaistu vapaa ja avoimen lähdekoodin valvontasovellus: saatavuus, vasteajat, häiriöt, hälytykset ja tilasivut. Tämä opas seuraa sen virallista Docker-imagea versiossa v4.0.0, ja ajoimme jokaisen komennon Simafrin VPS:llä ennen sen kirjoittamista: asennus Docker Composella, HTTPS, ensimmäinen tili, monitorit ja hälytykset, varmuuskopiot ja päivitykset.

Simon Vasconcelos Lee Kirjoittaja: Julkaistu 17. marraskuuta 2026Lukuaika: 12 minuuttia

Kaikki oppaat

Lyhyesti

  1. AGPL-3.0-lisenssi sallii Checkmaten käytön itsellenne, tiimillenne tai asiakkaillenne ostamatta lisenssiä; jos muokkaatte sitä ja annatte muiden käyttää sitä verkon kautta, jaatte muutoksenne.
  2. Asentakaa se Docker Composella: kaiken yhdessä sisältävä image ghcr.io/bluewave-labs/checkmate ja MongoDB 8.0, ja portti julkaistuna osoitteessa 127.0.0.1 HTTPS:llä toimivan käänteisen välityspalvelimen takana.
  3. Asettakaa JWT_SECRET, ENCRYPTION_KEY ja julkinen osoitteenne muuttujaan CLIENT_HOST, ja lisätkää NODE_ENV=production, joka viitetiedostosta puuttuu.
  4. Ensimmäisestä rekisteröityvästä tulee Superadmin: luokaa tilinne heti ensimmäisen käynnistyksen jälkeen, ja kaikki muut liittyvät sitten kutsulla.
  5. Varmuuskopioikaa MongoDB-tietokanta komennolla mongodump ja säilyttäkää .env-tiedostonne, ja päivittäkää sitten vaihtamalla imagen tagi: migraatiot ajetaan itsestään käynnistyksen yhteydessä.

Mitä Checkmate tekee

Checkmate tarkistaa palvelunne säännöllisin väliajoin, tallentaa jokaisen vastauksen ja sen vasteajan ja hälyttää teille, kun jokin lakkaa vastaamasta. Sen kehittäjä BlueWave Labs kuvaa sitä itse hostattavaksi työkaluksi, joka seuraa palvelinlaitteistoa, saatavuutta, vasteaikoja ja häiriöitä reaaliajassa.

Mitä AGPL-3.0-lisenssi sallii

Checkmate julkaistaan GNU Affero General Public License -lisenssin versiolla 3 (AGPL-3.0). Voitte käyttää sitä maksutta itsellenne, yrityksellenne tai asiakkaillenne, kopioida sitä ja muokata sitä.

Sen erityinen ehto koskee verkkokäyttöä: jos muokkaatte Checkmatea ja annatte muiden käyttää muokattua versiotanne verkon kautta, teidän on tarjottava heille sen lähdekoodi. Virallisen imagen ajaminen muokkaamattomana, kuten tässä oppaassa, ei synnytä tällaista velvoitetta. Ohjelmisto toimitetaan ilman takuuta.

Tarvittavat resurssit

Dokumentaatio asettaa vaatimattoman alarajan: mikä tahansa Linux-VPS, jossa on vähintään 1 Gt RAM-muistia. Se lisää, että MongoDB käyttää noin 400 Mt instanssissa, joka tarkistaa yli 300 palvelinta joka minuutti.

Palvelimen koko riippuu siis monitorien määrästä, tarkistusvälistä ja säilyttämästänne historiasta. Managed VPS -palvelimella kertokaa meille käytöstänne, niin suosittelemme sopivaa kokoa.

Asennus Docker Composella

Versiosta 3.10 alkaen Checkmate toimitetaan yhtenä imagena, ghcr.io/bluewave-labs/checkmate, joka tarjoaa sekä käyttöliittymän että rajapinnan. MongoDB toimii sen rinnalla omassa kontissaan. Luokaa palvelimelle, jolla on Docker Engine ja sen Compose-laajennus Dockerin Ubuntu-repositoriosta asennettuina, kansio kuten /opt/checkmate ja tallentakaa siihen tämä projektin viitetiedostoon perustuva compose.yaml:

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:

Kaksi salaisuutta tulevat sen viereen .env-tiedostoon, jonka Docker Compose lukee itsestään. Luokaa se vain rootin luettavaksi ja käynnistäkää sitten kokonaisuus:

Pääte, kansiossa /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

Ensimmäinen käynnistys ajaa tietokannan migraatiot; testi-VPS:llämme sovellus ilmoitti olevansa kunnossa alle kymmenessä sekunnissa. Tarkistaaksenne, että se vastaa:

Pääte
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

Ensimmäinen komento vastaa 200. Toinen vastaa "data":false niin kauan kuin yhtään tiliä ei ole, ja true, kun Superadmin on luotu.

Ensimmäinen tili, roolit ja kutsut

Checkmatessa ei ole oletustiliä. Ensimmäisestä rekisteröityvästä tulee Superadmin, joten luokaa omanne heti ensimmäisen käynnistyksen jälkeen, ennen kuin avaatte osoitteen yleisölle. SSH-tunneli tuo palvelimen portin 52345 tietokoneellenne osoitteeseen http://localhost:52345; lisätkää -p ja asiakasalueellanne näkyvä SSH-portti.

Pääte, tietokoneellanne
ssh -L 52345:127.0.0.1:52345 root@status.example.com
  1. Avatkaa http://localhost:52345: Checkmate näyttää rekisteröitymissivunsa.
  2. Syöttäkää etunimenne, sukunimenne, sähköpostiosoitteenne ja vähintään 8 merkin salasana, jossa on iso kirjain, pieni kirjain, numero ja erikoismerkki.
  3. Rekisteröitykää: päädytte kojelaudalle Superadminina kirjautuneena.

Siitä lähtien julkinen rekisteröityminen on suljettu: testi-VPS:llämme jokainen uusi kävijä ohjattiin kirjautumissivulle, ja rekisteröitymisosoite johti myös sinne. Muut liittyvät kutsulla tilin asetusten Team-osiosta roolilla User tai Admin. Kutsu lähtee sähköpostitse, joten se tarvitsee jäljempänä kuvatut SMTP-asetukset, ja sen linkki vanhenee tunnin kuluttua.

RooliMitä se voi tehdä
UserNähdä kaikki monitorit, kojelaudan, tarkistukset, häiriöt, tilasivut ja asetukset muuttamatta mitään
AdminKaiken, mitä User voi, sekä monitorit, ilmoituskanavat, häiriöt, huoltoikkunat, tilasivut, kutsut ja yleiset asetukset, SMTP mukaan lukien
SuperadminKaiken, mitä Admin voi, sekä tilien luomisen suoraan, toisen käyttäjän muokkaamisen, roolin tai salasanan vaihtamisen

Versiosta v4.0.0 alkaen tagit, tilasivut ja välityspalvelimet ovat Admin-toimintoja: User, joka saattoi hallita niitä aiemmin, menettää tämän pääsyn päivityksen jälkeen.

HTTPS: käänteinen välityspalvelin

Kontti tarjoaa Checkmaten HTTP:llä portissa 52345. HTTPS:stä huolehtii sen edessä oleva käänteinen välityspalvelin: dokumentaatio mainitsee Caddyn, Traefikin ja nginxin. Testasimme Caddyn, joka asennettiin sen virallisesta Debian- ja Ubuntu-repositoriosta: se hankkii Let’s Encryptin varmenteen itse, uusii sen ja välittää oletuksena otsakkeen Host ja otsakkeet X-Forwarded-*.

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

Ensimmäinen monitorinne ja sen hälytykset

  1. Napsauttakaa kohdassa ”Uptime” painiketta ”Create monitor” ja valitkaa HTTP/HTTPS.
  2. Syöttäkää tarkistettava osoite, nimi, jonka tunnistatte hälytyksestä, ja tarkistusväli: dokumentaatio suosittelee yhdestä viiteen minuuttia kriittiselle palvelulle.
  3. Tallentakaa: Checkmate tekee ensimmäisen tarkistuksen heti. Testi-VPS:llämme monitori näytti palvelun olevan saatavilla minuuttia myöhemmin.

Sähköposti: SMTP-asetukset

Sähköpostihälytykset ja kutsut kulkevat koko palvelimen yhteisen SMTP-yhteyden kautta, joka asetetaan kohdassa ”Settings”, välilehdellä ”Email”: palvelin, portti, käyttäjä, salasana ja lähettäjän osoite, sitten ”Save” ja ”Test”. Käyttäkää Simafrin VPS:llä todennettua SMTP-palvelinta portissa 587 tai 465: verkkotunnuksenne sähköpostipalvelua tai lähetyspalvelua. Luokaa sitten sähköposti-ilmoitus hälytettävine osoitteineen ja liittäkää se monitoreihinne.

Slack, Discord, Teams, Telegram ja muut kanavat luodaan samalla tavalla kohdassa ”Notifications”, kukin webhook-osoitteineen tai tunnuksineen ja kukin ”Test”-painikkeineen.

Heartbeat-monitorit ajastettuja tehtäviänne varten

Heartbeat-monitori valvoo tehtävää, joka ajetaan itsestään, kuten öistä varmuuskopiointia. Luokaa tiimin ping-avain kohdassa ”Settings”, välilehdellä ”Monitoring” (se näytetään vain kerran), luokaa Heartbeat-monitori slugilla ja hälytysikkunalla ja kutsukaa sitten sen ping-osoitetta tehtävän lopussa:

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"

Kun osoitteeseen lisätään /fail tai tehtävän paluukoodi, monitori merkitään heti alhaalla olevaksi odottamatta ikkunan umpeutumista.

Tilasivut

Kohdassa ”Status pages” Admin julkaisee sivun, joka luettelee valitut monitorit ja niiden saatavuuden asiakkaillenne tai tiimillenne. Versiosta v4.0.0 alkaen jokaisella tilasivulla on aikavyöhyke, oletuksena UTC.

Varmuuskopiot

Kaikki on kahdessa paikassa: MongoDB-tietokannassa taltiossa mongo-data ja .env-tiedostossanne. Säilyttäkää jälkimmäinen turvassa: ENCRYPTION_KEY tarvitaan tietokantaan tallennettujen salaisuuksien lukemiseen, ja JWT_SECRET pitää käyttäjänne kirjautuneina. MongoDB-image sisältää työkalun mongodump:

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

Ajastakaa tämä kopio ja lähettäkää se palvelimen ulkopuolelle; Heartbeat-monitori voi kertoa teille, jos se joskus lakkaa toimimasta. Levylle tallennettuina arkistot sisältyvät myös palvelimen öisiin varmuuskopioihin.

Palautus

Samassa tai uudessa asennuksessa, samalla .env-tiedostolla, pysäyttäkää sovellus, ladatkaa arkisto ja käynnistäkää sovellus sitten uudelleen:

Pääte, kansiossa /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

Testasimme koko kierroksen VPS:llämme: varmuuskopio, tietokannan todellinen poistaminen, palautus. Monitori ja tili palasivat, ja kirjautuminen toimi heti uudelleen.

Checkmate v4.0.0 tarjoaa myös salattuja pilvivarmuuskopioita Checkmate Connectin kautta. Se on valinnainen, betavaiheen ajan maksuton palvelu, joka tarvitsee ENCRYPTION_KEY-avaimen ja Superadminin asennuksen rekisteröimiseksi. Yllä kuvatut kopiot toimivat ilman sitä.

Päivitykset

Lukekaa julkaisutiedotteet, ottakaa varmuuskopio, vaihtakaa imagen tagi tiedostossa compose.yaml, hakekaa sitten uusi image ja luokaa kontti uudelleen. Tietokannan migraatiot ajetaan itsestään käynnistyksen yhteydessä:

Pääte, kansiossa /opt/checkmate
docker compose pull
docker compose up -d
docker compose logs checkmate | grep -i migration

Telemetria

Checkmate lähettää päivittäin yhden anonyymin raportin: asennustunnisteen, version, asennustavan ja kunkin tyyppisten monitorien määrän, eikä koskaan osoitteitanne tai tuloksianne. Se kertoo tästä lokissaan käynnistyksen yhteydessä. Poistaaksenne sen käytöstä lisätkää TELEMETRY_ENABLED=false palvelun checkmate ympäristöön ja ajakaa sitten docker compose up -d.

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; Checkmate pysyy teidän ohjelmananne monitoreineen ja asetuksineenne.

AiheTiimimmeTe
PalvelinJärjestelmä- ja tietoturvapäivitykset, toimenpiteet palvelimella mukaan lukienToimintaanne sopiva ajankohta
ValvontaPalvelinta seurataan ympäri vuorokauden joka päivä, ja puututaan asiaan odottamatta yhteydenottoanneOmat monitorinne, hälytyksenne ja tilasivunne Checkmatessa
CheckmateProaktiivinen seuranta: virheet, hitaus, tietokanta ja levytila havaitaan, ja korjausta suositellaanSen asennus, päivitykset ja asetukset, jotka toteutatte itse tai tekoälyavustajanne kanssa
Käyttäjät ja hälytyksetNiitä kantava palvelin, valvottuna ja varmuuskopioitunaTilit, roolit, kutsut ja ilmoituskanavat
VarmuuskopiotJoka yö, salattuina ja koneen ulkopuolella säilytettyinä; palautus sisältyyCheckmaten omat tietokantaviennit sekä palautuspyyntö, kun tarvitsette sitä
SiirtoNykyinen palvelimenne siirretään, veloituksettaKäyttöönoton ajankohta

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

Checkmate palvelimella, jota ylläpidetään puolestanne

Simafrin Managed VPS -palvelussa tiimimme pitävät Checkmate-instanssinne palvelimen ajan tasalla, valvovat sitä yötä päivää ja toimivat odottamatta yhteydenottoanne; ne seuraavat myös instanssianne proaktiivisesti ja suosittelevat teille hyödyllisiä korjauksia, jotka toteutatte itse tai tekoälyavustajanne kanssa. Varmuuskopiot salataan joka yö ja säilytetään koneen ulkopuolella, niiden palautus sisältyy, ja nykyisen palvelimenne siirto tehdään veloituksetta.

Katso Managed VPS

Usein kysytyt kysymykset

Onko Checkmate maksuton?

Kyllä. Checkmate on AGPL-3.0-lisenssin alainen: voitte ajaa sitä itsellenne, tiimillenne tai asiakkaillenne ostamatta lisenssiä. Jos muokkaatte sitä ja annatte muiden käyttää sitä verkon kautta, jaatte muutoksenne. Kuluksi jää sitä ajavan palvelimen hinta.

Miten Checkmate asennetaan Docker Composella?

Käyttäkää viitetiedostoa compose.yaml: image ghcr.io/bluewave-labs/checkmate ja MongoDB 8.0. Tallentakaa JWT_SECRET ja ENCRYPTION_KEY .env-tiedostoon, asettakaa CLIENT_HOST https-osoitteeseenne ja NODE_ENV arvoon production, julkaiskaa portti 52345 osoitteessa 127.0.0.1, ajakaa docker compose up -d ja sijoittakaa eteen HTTPS:llä toimiva käänteinen välityspalvelin.

Mitkä ovat Checkmaten oletustunnukset?

Niitä ei ole. Ensimmäisestä uuteen instanssiin rekisteröityvästä tulee Superadmin. Luokaa tilinne heti ensimmäisen käynnistyksen jälkeen SSH-tunnelin kautta; sen jälkeen kävijät ohjataan kirjautumissivulle ja uudet käyttäjät liittyvät kutsulla.

Kuinka paljon muistia Checkmate tarvitsee?

Dokumentaatio edellyttää Linux-VPS:ää, jossa on vähintään 1 Gt RAM-muistia. Testi-VPS:llämme juuri tehty asennus käytti noin 300 Mt Checkmatelle ja 280 Mt MongoDB:lle. Levyn tarve kasvaa monitorien määrän, tarkistusvälin ja säilyttämänne historian mukaan, oletuksena 90 päivää.

Miten Checkmaten hälytykset lähetetään sähköpostitse?

Asettakaa SMTP-yhteys kohdassa Settings, välilehdellä Email: palvelin, portti 587 tai 465, käyttäjä, salasana ja lähettäjä, sitten Save ja Test. Luokaa sähköposti-ilmoitus hälytettävine osoitteineen ja liittäkää se monitoreihinne. Kutsut käyttävät samoja asetuksia.

Miten Checkmate varmuuskopioidaan?

Viekää MongoDB-tietokanta komennolla docker compose exec -T mongodb mongodump --archive --gzip --db uptime_db ja säilyttäkää kopio .env-tiedostostanne, jonka ENCRYPTION_KEY tarvitaan tallennettujen salaisuuksien lukemiseen. Palauttakaa komennolla mongorestore --archive --gzip --drop sovelluksen ollessa pysäytettynä.

Miten Checkmate päivitetään?

Lukekaa julkaisutiedotteet ja ottakaa varmuuskopio, vaihtakaa imagen tagi tiedostossa compose.yaml ja ajakaa sitten docker compose pull ja docker compose up -d. Tietokannan migraatiot ajetaan itsestään käynnistyksen yhteydessä.

Kattaako Managed VPS Checkmaten?

Managed VPS kattaa palvelimen: järjestelmän, tietoturvan, valvonnan ja varmuuskopiot. Tiimimme seuraavat myös instanssianne proaktiivisesti ja suosittelevat hyödyllisiä korjauksia, jotka toteutatte itse. Toimenpide sovelluksessa laskutetaan tuntiveloituksella tai kiinteällä hinnalla.

Lähteet ja virallinen dokumentaatio

Aiheeseen liittyvät oppaat

Näin hostaatte Uptime Kuman Managed VPS:llä: valvokaa palveluitanne jatkuvastiUptime Kuman hostaus Managed VPS:llä tarkoittaa, että valvotte verkkosivustojanne, rajapintojanne ja palvelimianne koneelta, joka on teidän ja jota tiimimme pitävät ajan tasalla ja valvovat yötä päivää. Uptime Kuma on MIT-lisenssillä julkaistu avoimen lähdekoodin ohjelma. Tämä opas seuraa sen virallista dokumentaatiota: asennus Docker Composella, HTTPS, tietokanta, ilmoitukset, varmuuskopiot ja päivitykset.VPS:n varmuuskopiot: mitä tarkistaa ennen allekirjoitustaVPS-tarjous lupaa lähes aina ”varmuuskopiot sisältyvät”. Näiden sanojen takana voi olla joka yö otettava kopio, joka säilytetään koneen ulkopuolella ja jonka asiantuntijat palauttavat, tai tilannevedos samalla levyllä kuin palvelin. Tämä opas antaa kysymykset, jotka tekevät eron, kertoo, mitä kukin vastaus tarkoittaa, ja näyttää, miten varmistatte, että varmuuskopio palautuu.Hallinnoidun ja hallinnoimattoman VPS:n ero: kuka tekee mitäHallinnoidun ja hallinnoimattoman VPS:n ero palautuu yhteen kysymykseen: kuka huolehtii palvelimesta, kun se on käynnissä. Sanalla ”hallinnoitu” ei kuitenkaan ole virallista määritelmää, ja palveluntarjoajasta riippuen se kattaa kaiken järjestelmän pelkästä asennuksesta palvelimen täyteen ylläpitoon. Tämä opas näyttää rivi riviltä, kuka tekee mitäkin, myös tuetulla välitasolla, ja antaa kysymykset, jotka poistavat epäselvyydet ennen allekirjoitusta.
Ota yhteyttä