Näin hostaatte Listmonkin Managed VPS:llä: uutiskirjeet omalla palvelimellanne

Mitä Listmonk tekee

Listmonk hallinnoi postituslistojanne ja uutiskirjeitänne verkkokäyttöliittymästä. Se on yksi Go-kielellä kirjoitettu ohjelma, jonka ainoa riippuvuus on PostgreSQL. Sen listat ovat yksisuuntaisia: kirjoitatte tilaajillenne, eikä kyseessä ole heidän keskinäinen keskusteluluettelonsa.

• Listat: yksinkertaisen tai kaksinkertaisen opt-inin listat miljooniin tilaajiin asti sekä segmentointi SQL-lausekkeilla tilaajien attribuuttien perusteella.
• Kampanjat: visuaalinen vedä ja pudota -editori, WYSIWYG-editori, Markdown, HTML tai pelkkä teksti sekä Go-kielen pohjat yli 100 funktiolla.
• Tilastot: avaukset, klikkaukset, palautuvat viestit ja seuratuimmat linkit kampanja kerrallaan.
• Transaktioviestit: rajapinta viestin lähettämiseen pohjan perusteella, esimerkiksi tilausvahvistus. HTTP-webhook-”messengerit” avaavat myös tekstiviestin tai WhatsAppin, liitettävissä valitsemaanne palveluun.
• Tilaajat: sivu, jolla jokainen hallitsee asetuksiaan, vie tietonsa tai poistaa ne.
• Tiimi: tarkat roolit ja oikeudet, OIDC-kertakirjautuminen ja rajatut API-tunnukset.
• Media: kuvakirjasto levyllä tai S3-yhteensopivassa tallennustilassa.

Mitä AGPL-3.0-lisenssi sallii

Listmonk julkaistaan GNU AGPL version 3 -lisenssillä. Voitte käyttää sitä myös yrityksessä ja lähettää omia ja asiakkaidenne kampanjoita ilman ostettavaa lisenssiä. Jäljelle jäävät palvelimen ja lähetyspalvelunne kustannukset.

Pykälä 13 lisää AGPL:lle ominaisen ehdon: jos muokkaatte ohjelmaa, versionne on tarjottava selkeästi kaikille, jotka käyttävät sitä etäyhteydellä verkon kautta, mahdollisuus saada sen lähdekoodi maksutta. Jos jaatte kopioita, lisenssin koodin jakamista koskevat velvoitteet pätevät myös. Listmonkin ajaminen muokkaamatta ei laukaise tätä pykälää.

Minkä Listmonk-version asentaa?

Yksi seikka kannattaa tietää ennen aloittamista. GitHubissa tunniste ”Latest” osoittaa tällä hetkellä versioon v7.0.0-beta.2, 10. marraskuuta 2026, jonka projekti itse esittelee betana. Viimeisin vakaa versio on v6.2.0, joka sisältää tietoturvakorjauksia oikeuksiin. 11. marraskuuta 2026 Docker-image latest osoittaa tähän v6.2.0:aan.

Versio 7 korvaa koko ylläpitokäyttöliittymän, muuttaa joitakin sen osoitteita, tekee asetuksesta app.from_email osoiteluettelon ja muuttaa käännösavaimia, mikä vaikuttaa mukautettuihin pohjiin. Lukekaa sen julkaisutiedot ennen siirtymistä.

Projektin Compose-tiedosto ajaa --upgrade --yes jokaisessa käynnistyksessä: uusi image migroi tietokannan kysymättä. Migroitua tietokantaa ei kuitenkaan voi lukea vanhemmalla versiolla, ja paluu vaatii varmuuskopion palauttamista. Kiinteällä tunnisteella, kuten v6.2.0, versionvaihto pysyy teidän päätöksenänne.

Asennus Docker Composella

Projekti suosittelee Docker Composea: sen tiedosto käynnistää Listmonkin ja PostgreSQL:n yhdessä. Luokaa palvelimelle, jolle Docker on asennettu, kansio ja noutakaa tämä tiedosto:

mkdir listmonk
cd listmonk
curl -LO https://github.com/knadh/listmonk/raw/master/docker-compose.yml

Projekti pyytää mukauttamaan tämän tiedoston ympäristöönne. Tässä ovat ainoat muutettavat rivit, loput eivät muutu:

x-db-credentials: &db-credentials
  POSTGRES_USER: &db-user listmonk
  POSTGRES_PASSWORD: &db-password un-mot-de-passe-long
  POSTGRES_DB: &db-name listmonk

services:
  app:
    image: listmonk/listmonk:v6.2.0
    ports:
      - "127.0.0.1:9000:9000"
    hostname: listmonk.example.com

• Tietokannan salasana: tiedosto antaa lähtöarvoksi listmonk. Vaihtakaa se ennen ensimmäistä käynnistystä, sillä PostgreSQL-image lukee tämän muuttujan vain tyhjästä datakansiosta.
• Image: tietty versio tunnisteen latest tilalle, edellä kerrotusta syystä.
• Portti julkaistaan osoitteessa 127.0.0.1: tämä on oma mukautuksemme. Projektin tiedosto julkaisee portin 9000 ilman osoiterajausta ja rajaa PostgreSQL:n jo paikalliseen osoitteeseen. Samalla tavalla käsiteltynä Listmonkiin pääsee vain käänteisen välityspalvelimen kautta.
• Isäntänimi: tiedosto neuvoo täydellistä verkkotunnusta.

Käynnistäkää sitten palvelut luoden Super Admin -tili etukäteen. Nämä kaksi muuttujaa palvelevat vain ensimmäistä käynnistystä, ja ilman niitä tili luodaan käyttöliittymän ensimmäisellä käyntikerralla: parempi, että se on olemassa ennen verkkotunnuksenne avaamista.

LISTMONK_ADMIN_USER=votre-identifiant LISTMONK_ADMIN_PASSWORD=votre-mot-de-passe docker compose up -d

Ilman Dockeria: binääri

Listmonk toimii myös yksittäisenä ohjelmana oman PostgreSQL-palvelimenne rinnalla, versiossa 12 tai uudemmassa, jossa tietokanta on jo luotu.

1. Ladatkaa v6.2.0:n arkisto projektin versiosivulta, esimerkiksi listmonk_6.2.0_linux_amd64.tar.gz, välttäen ensimmäisenä näkyvää betaa, ja purkakaa binääri.
2. Luokaa asetustiedosto ja täyttäkää tietokannan tunnukset tiedostoon config.toml.
3. Asentakaa taulut ja käynnistäkää sitten Listmonk.

./listmonk --new-config
./listmonk --install
./listmonk

Oletuksena config.toml kuuntelee osoitetta localhost:9000, mikä sopii käänteisen välityspalvelimen taakse. Repositorio toimittaa systemd-palvelutiedoston listmonk@.service.

Palvelimen koko

Projektin sivusto mainitsee tuotantoinstanssin, joka lähettää yli 7 miljoonan sähköpostin kampanjan murto-osalla suorittimen ytimestä ja 57 Mt:n muistipiikillä. Se ei julkaise vähimmäisvaatimusta eikä lukua PostgreSQL:lle, jonka tilavuus kasvaa tilaajien, avausten ja klikkausten mukana. Managed VPS -palvelimella kuvailkaa meille käyttötarkoituksenne, niin suosittelemme sopivaa kokoa.

HTTPS ja käänteinen välityspalvelin

Tilaajanne klikkaavat linkkejä, jotka osoittavat instanssiinne: tilauksen peruutus, vahvistus, klikkausten seuranta. Se tarjotaan siksi HTTPS:llä omalla verkkotunnuksellaan. Luokaa tämän nimen A- ja AAAA-tietueet palvelimeenne, jonne kävijät saapuvat portteihin 80 ja 443. Listmonkin dokumentaatio jättää välityspalvelimen valinnan vapaaksi, tässä kaksi yleistä asetusta.

Caddyllä

Caddy hankkii ja uusii varmenteen itse:

listmonk.example.com {
    reverse_proxy 127.0.0.1:9000
}

Nginxillä ja Certbotilla

Nginx hylkää oletuksena yli 1 Mt:n pyynnöt virheellä 413. Tilaajatiedoston tai kuvien tuontia varten nostakaa tätä rajaa tiedostojenne mukaan:

server {
    listen 80;
    listen [::]:80;
    server_name listmonk.example.com;
    client_max_body_size 100m;

    location / {
        proxy_pass http://127.0.0.1:9000;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

Certbot asentaa sen jälkeen Let’s Encrypt -varmenteen ja uudelleenohjauksen HTTPS:ään ja uusii varmenteen sitten itse:

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

Ensimmäiset asetukset

Kirjautukaa osoitteessa https://listmonk.example.com/admin ja avatkaa sitten ”Settings”:

• ”General”, ”Root URL”: instanssinne julkinen osoite ilman loppukauttaviivaa, kuten https://listmonk.example.com. Listmonk muodostaa siitä sähköpostiensa peruutus-, vahvistus- ja seurantalinkit. Sen lähtöarvo, http://localhost:9000, ei toimisi tilaajillanne.
• ”General”, ”Default from email”: oletuslähettäjän osoite, verkkotunnuksellanne, annetun esimerkin tilalle.
• ”Media”, ”Upload path”: /listmonk/uploads, kansio, jonka Compose-tiedosto liittää palvelimelle.
• ”General”: julkinen tilaussivu ja julkinen arkisto ovat aluksi käytössä. Säilyttäkää ne, jos niille on käyttöä.
• ”Security”, ”Enable CAPTCHA”: aluksi pois päältä, se suojaa julkista tilauslomaketta.

Mikä pysyy julkisena, mikä voidaan sulkea

Pääsyn suodattamiseksi IP-osoitteen tai todennusvälityspalvelimen avulla dokumentaatio jakaa reitit näin:

Lähetys: Listmonk kulkee SMTP-palvelinten kautta

Listmonk valmistelee ja tahdittaa sähköpostinne ja uskoo ne sitten SMTP-palvelimille, jotka ilmoitatte kohdassa ”Settings”, ”SMTP”. Se ei toimita niitä itse tilaajienne postilaatikoihin: toimituksen laatu riippuu siis tästä palvelimesta, verkkotunnuksestanne ja listoistanne.

Massalähetykseen valitkaa erikoistunut lähetyspalvelu: se kantaa lähetystenne maineen ja verkkotunnuksenne allekirjoitukset ja osaa palauttaa palautuvat viestit. Simafrin VPS:ltä lähetys kulkee todennetun SMTP-releen kautta portissa 587: tässä tämän palvelun releen kautta.

Suuntaa-antavasti Listmonkin dokumentaatio kuvaa palautuvat viestit Amazon SES:stä, Azure Communication Servicesistä, SendGridistä, Postmarkista, Forward Emailistä ja Lettermintistä. Vertailkaa niitä volyymin ja vastaanottajienne mukaan.

Napsauttakaa sitten ”Test connection”: Listmonk lähettää koeviestin ja näyttää palvelimen virheen, jos lähetys epäonnistuu. Voitte ilmoittaa useita palvelimia, valita yhden kampanjakohtaisesti tai reitittää lähetykset lähettäjän osoitteen tai verkkotunnuksen mukaan.

Läpäisykyky

Säätäkää se kohdassa ”Settings”, ”Performance”, palvelunne rajan alapuolelle:

• ”Concurrency” ja ”Message rate”: lähetyssäikeiden määrä ja viestien määrä sekunnissa kullekin. Lähtöarvot, 10 ja 10, sallivat jopa 100 viestiä sekunnissa.
• ”Batch size”: tietokannasta kullakin kierroksella luettavien tilaajien määrä, aluksi 1 000, pidettävä tavoitellun läpäisykyvyn yläpuolella. Korkeammalla se kuluttaa enemmän muistia.
• ”Enable sliding window limit”: viestien enimmäismäärä ajanjaksolle, hyödyllinen, kun palvelunne laskee tunneittain.
• ”Maximum error threshold”: virheiden määrä, jonka jälkeen kampanja keskeytetään.

Epäonnistunut viesti yritetään uudelleen asetuksen ”Retries” mukaan, palvelimen muilla yhteyksillä. Jos se epäonnistuu yhä, Listmonk merkitsee sen virheeksi ja siirtyy seuraavaan: seuratkaa näitä virheitä suuren kampanjan aikana.

Toimitusvarmuus, tilauksen peruutus ja suostumus

Sovelluksen hostaaminen jättää nämä asiat teidän hallintaanne, ja juuri ne ratkaisevat, saapuvatko sähköpostinne perille.

SPF, DKIM ja DMARC

Lähettäkää verkkotunnuksenne osoitteesta ja julkaiskaa sen DNS-vyöhykkeessä SPF- ja DKIM-tietueet, jotka lähetyspalvelunne antaa, sekä DMARC-tietue. Google vaatii kaikki kolme lähettäjiltä, jotka lähettävät yli 5 000 viestiä päivässä Gmail-tileille, lähetysverkkotunnuksen yhdenmukaisena SPF:n tai DKIM:n kanssa, markkinointiviestien tilauksen peruutuksen yhdellä napsautuksella sekä roskapostiksi ilmoittamisen asteen alle 0,30 %, mieluiten alle 0,10 %.

Tilauksen peruutus

• Viestissä: sijoittakaa {{ UnsubscribeURL }} pohjanne alatunnisteeseen. Tämä linkki vie asetusten hallintaan ja tilauksen peruutukseen.
• Otsakkeissa: kohdan ”Settings”, ”Privacy” valinta ”Include List-Unsubscribe header”, aluksi käytössä, mahdollistaa sähköpostiohjelmille tilauksen peruutuksen tarjoamisen yhdellä napsautuksella.
• Tiedot: sama asetussivu jättää tilaajalle oikeuden viedä tietonsa, poistaa ne ja siirtyä estolistalle. Nämä valinnat ovat aluksi käytössä.

Vastaanottajienne suostumus

Listmonk soveltaa valitsemaanne listatyyppiä. Yksinkertaisen opt-inin listalla ilman vahvistusta lisätty tilaaja saa silti kampanjanne. Kaksinkertaisen opt-inin listalla hän saa ensin vahvistussähköpostin, ja vain vahvistaneet tilaajat saavat kampanjanne. Tämä valinta suojaa parhaiten lähetysmainettanne ja säilyttää selkeän jäljen suostumuksesta.

Säännöt riippuvat vastaanottajienne maasta. Esimerkiksi Ranskassa CNIL vaatii yksityishenkilöiden ennakkosuostumuksen myönteisellä toimella, kuten ruudulla, jota ei ole valmiiksi rastitettu, poikkeuksena omat asiakkaanne samankaltaisten tuotteiden tai palveluiden osalta. Yritysten välillä markkinointi voi perustua oikeutettuun etuun, jos se koskee heidän ammattiaan. Joka tapauksessa jokainen viesti tunnistaa lähettäjän ja tarjoaa helpon tavan kieltäytyä seuraavista.

Kirjoittakaa vain ihmisille, jotka odottavat viestejänne. Ostettu tai vanha lista nostaa palautuvien viestien ja roskaposti-ilmoitusten määrää, ja seuraukset kantaa verkkotunnuksenne.

Avausten ja klikkausten seuranta

Seurantapikseli ja klikkausten seuranta koskettavat yksityisyyttä, ja dokumentaatio pyytää käyttämään niitä esimerkiksi GDPR:n kaltaisia sääntöjä noudattaen. Oletuksena tätä seurantaa ei liitetä yksittäiseen tilaajaan: valinta ”Individual subscriber tracking” liittää sen, ja ”Disable tracking” katkaisee sen kokonaan, kohdassa ”Settings”, ”Privacy”.

Palautuvat viestit

Jatkuva kirjoittaminen osoitteeseen, joka hylkää viestinne, heikentää lähetysmainettanne. Palautuvien viestien käsittely on aluksi pois päältä: ottakaa se käyttöön kohdassa ”Settings”, ”Bounces” ja valitkaa sitten jompikumpi näistä kahdesta tiestä.

• Lähetyspalvelunne webhook: ottakaa käyttöön ”Enable bounce webhooks” ja palvelunne valinta. Listmonk vastaanottaa SES:n, Azure Communication Servicesin, SendGridin, Postmarkin, Forward Emailin ja Lettermintin palautuvat viestit osoitteeseen, kuten https://listmonk.example.com/webhooks/service/ses, jonka viimeinen sana vaihtelee palvelun mukaan. Tämän osoitteen on pysyttävä julkisena.
• POP3-postilaatikko: Listmonk lukee uudelleen postilaatikkoa, joka vastaanottaa palautuvat viestit, lähettäjäosoitteenne tai erillisen laatikon. Se päättelee silloin palautuksen tyypin viestin sisällöstä ja pitää kevyenä sitä, mitä ei tunnista.

Erillistä laatikkoa varten ilmoittakaa se paluuosoitteeksi kohdassa ”Settings”, ”SMTP”, ”Custom headers”:

[
  {"Return-Path": "your-bounce-inbox@example.com"}
]

Lähtöasetukset ovat ne, jotka dokumentaatio antaa SES:lle, ja ne muodostavat hyvän pohjan:

PostgreSQL, ainoa riippuvuus

Listmonk vaatii PostgreSQL 12:n tai uudemman. Compose-tiedosto tuo mukanaan postgres:17-alpine:n, tiedot Docker-taltiossa listmonk-data. Tilaajat, kampanjat, pohjat, tilastot ja suurin osa asetuksista ovat siellä; vain tietokannan tunnukset ja kuunteluosoite pysyvät asetuksissa.

Osoittaaksenne olemassa olevaan PostgreSQL-palvelimeen muokatkaa palvelun app muuttujia LISTMONK_db__host, LISTMONK_db__port, LISTMONK_db__user, LISTMONK_db__password ja LISTMONK_db__database.

Listmonk on suunniteltu suurille listoille. Tietokannan kasvaessa juuri se voi hidastaa käyttöliittymää: miljoonilla tilaajilla kojelauta ja laskurit voivat kestää kymmeniä sekunteja näkyä. Projekti neuvoo silloin kahta toimenpidettä:

• ”Cache slow database queries”, kohdassa ”Settings”, ”Performance”: laskurit lasketaan säännöllisin väliajoin, oletuksena joka yö kello 3.
• VACUUM ANALYZE suurella tietokannalla, esimerkiksi viikoittain. Komento estää kyselyt ajonsa ajaksi, yleensä muutamaksi sekunniksi.

docker compose exec db psql -U listmonk -d listmonk -c 'VACUUM ANALYZE;'

Varmuuskopiot ja päivitykset

Instanssinne muodostuu kahdesta osasta: PostgreSQL-tietokannasta ja kansiosta uploads, jos kuvanne pysyvät levyllä. pg_dump tuottaa yhtenäisen viennin pysäyttämättä Listmonkia tai estämättä muita pääsyjä tietokantaan:

docker compose exec -T db pg_dump -U listmonk listmonk > listmonk-$(date +%F).sql
tar -czf listmonk-uploads-$(date +%F).tar.gz uploads

Palauttaaksenne pysäyttäkää Listmonk, tyhjentäkää tietokanta ja ladatkaa vienti uudelleen. Kuten dokumentaatio täsmentää, tämä toimenpide tyhjentää käytössä olevan tietokannan:

docker compose stop app
docker compose exec db psql -U listmonk -d listmonk -c 'DROP SCHEMA public CASCADE; CREATE SCHEMA public;'
docker compose exec -T db psql -U listmonk -d listmonk < listmonk-2026-11-01.sql
docker compose start app

Päivittäminen

1. Lukekaa uuden version julkaisutiedot: Listmonk ilmoittaa uusista versioista käyttöliittymässään, ja osa sisältää tietoturvakorjauksia.
2. Viekää tietokanta, kuten projekti pyytää ennen jokaista päivitystä.
3. Vaihtakaa imagen tunniste tiedostossa docker-compose.yml.
4. Ajakaa dokumentaation komennot. Compose-tiedosto migroi tietokannan käynnistyksessä.

docker compose down app
docker compose pull
docker compose up app -d

Binäärillä pysäyttäkää Listmonk, korvatkaa binääri, ajakaa ./listmonk --upgrade ja käynnistäkää se sitten uudelleen. Palataksenne aiempaan versioon palauttakaa ennen päivitystä otettu vienti ja asettakaa sitten vanha tunniste takaisin.

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; Listmonk pysyy teidän ohjelmananne asetuksineen, listoineen ja kampanjoineen.

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