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.
Kirjoittaja: Simon Vasconcelos Lee
Julkaistu 17. marraskuuta 2026Lukuaika: 12 minuuttia
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.JWT_SECRET, ENCRYPTION_KEY ja julkinen osoitteenne muuttujaan CLIENT_HOST, ja lisätkää NODE_ENV=production, joka viitetiedostosta puuttuu.mongodump ja säilyttäkää .env-tiedostonne, ja päivittäkää sitten vaihtamalla imagen tagi: migraatiot ajetaan itsestään käynnistyksen yhteydessä.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.
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.
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.
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:
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:
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
127.0.0.1: viitetiedosto julkaisee sen ilman osoitetta, jolloin Docker avaa sen palvelimen kaikkiin osoitteisiin. Paikallisesti julkaistuna siihen pääsee vain käänteisen välityspalvelimen kautta.CLIENT_HOST on osoite, jonka käyttäjänne kirjoittavat, muodossa https://. Checkmate käyttää sitä eri alkuperien tarkistuksiin sekä hälytystensä ja sähköpostiensa linkkeihin.NODE_ENV=production: README pyytää sitä todellisissa käyttöönotoissa. Ilman sitä sovellus toimii kehitystilassa, mikä poistaa rajapinnan pyyntörajoittimen käytöstä.ENCRYPTION_KEY on viitetiedostossa valinnainen. Se salaa Checkmaten tallentamat salaisuudet, ja v4.0.0 vaatii sen TLS:ää käyttäville Docker-monitoreille ja Checkmate Connectille. Asettakaa se alusta alkaen: se on helpompaa kuin sen lisääminen myöhemmin.latest ja hakee sen jokaisella käynnistyksellä. Täydellisellä versionumerolla, tässä v4.0.0, päätätte itse, milloin kukin päivitys tehdään.mongo-data sisältää kaikki tietonne: monitorit, tarkistukset, käyttäjät ja asetukset.Ensimmäinen käynnistys ajaa tietokannan migraatiot; testi-VPS:llämme sovellus ilmoitti olevansa kunnossa alle kymmenessä sekunnissa. Tarkistaaksenne, että se vastaa:
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.
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.
ssh -L 52345:127.0.0.1:52345 root@status.example.com
http://localhost:52345: Checkmate näyttää rekisteröitymissivunsa.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.
| Rooli | Mitä se voi tehdä |
|---|---|
| User | Nähdä kaikki monitorit, kojelaudan, tarkistukset, häiriöt, tilasivut ja asetukset muuttamatta mitään |
| Admin | Kaiken, mitä User voi, sekä monitorit, ilmoituskanavat, häiriöt, huoltoikkunat, tilasivut, kutsut ja yleiset asetukset, SMTP mukaan lukien |
| Superadmin | Kaiken, 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.
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-*.
status.example.com {
reverse_proxy 127.0.0.1:52345
}
sudo systemctl reload caddy
CLIENT_HOST on sisällettävä sama https://-osoite kuin välityspalvelimella. Kun olette muuttaneet sitä, ajakaa docker compose up -d, joka luo kontin uudelleen.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-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:
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.
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.
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:
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.
Samassa tai uudessa asennuksessa, samalla .env-tiedostolla, pysäyttäkää sovellus, ladatkaa arkisto ja käynnistäkää sovellus sitten uudelleen:
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ä.
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ä:
docker compose pull
docker compose up -d
docker compose logs checkmate | grep -i migration
mongodump ja mongorestore. Uutta ympäristömuuttujaa ei tarvita.checkmate-client, checkmate-backend ja checkmate-mongo, joita ei enää päivitetä. Siirtykää imageen ghcr.io/bluewave-labs/checkmate ja säilyttäkää MongoDB-palvelunne ja sen taltio; muuttujia UPTIME_APP_* ei enää lueta.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.
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.
| Aihe | Tiimimme | Te |
|---|---|---|
| Palvelin | Järjestelmä- ja tietoturvapäivitykset, toimenpiteet palvelimella mukaan lukien | Toimintaanne sopiva ajankohta |
| Valvonta | Palvelinta seurataan ympäri vuorokauden joka päivä, ja puututaan asiaan odottamatta yhteydenottoanne | Omat monitorinne, hälytyksenne ja tilasivunne Checkmatessa |
| Checkmate | Proaktiivinen seuranta: virheet, hitaus, tietokanta ja levytila havaitaan, ja korjausta suositellaan | Sen asennus, päivitykset ja asetukset, jotka toteutatte itse tai tekoälyavustajanne kanssa |
| Käyttäjät ja hälytykset | Niitä kantava palvelin, valvottuna ja varmuuskopioituna | Tilit, roolit, kutsut ja ilmoituskanavat |
| Varmuuskopiot | Joka yö, salattuina ja koneen ulkopuolella säilytettyinä; palautus sisältyy | Checkmaten omat tietokantaviennit sekä palautuspyyntö, kun tarvitsette sitä |
| Siirto | Nykyinen palvelimenne siirretään, veloituksetta | Käyttöönoton ajankohta |
Jos haluatte tiimiemme toimivan itse sovelluksessa, tämä palvelu laskutetaan tuntiveloituksella tai kiinteällä hinnalla, ja arvio annetaan ennen toimenpidettä.
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.
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.
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.
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.
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ää.
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.
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ä.
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ä.
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.
Simafri
Jutellaan hankkeestasi
Kerro meille muutamalla sanalla, mitä tarvitset: vastaamme sinulle nopeasti.
Kiitos! Pyyntösi on lähetetty. Vastaamme sinulle pian.
Suositko sähköpostia? Kirjoita meille osoitteeseen support@simafri.com.