Hostati Listmonk na Managed VPS-u: vaši newsletteri na vašem poslužitelju

Što radi Listmonk

Listmonk upravlja vašim popisima za slanje i newsletterima iz web-sučelja. To je jedan program, napisan u Gou, čija je jedina ovisnost PostgreSQL. Njegovi su popisi jednosmjerni: vi pišete svojim pretplatnicima, a ne radi se o popisu za raspravu među njima.

• Popisi: popisi s jednostrukom ili dvostrukom potvrdom (opt-in), do milijuna pretplatnika, i segmentacija SQL izrazima po njihovim atributima.
• Kampanje: vizualni uređivač povlačenjem i ispuštanjem, WYSIWYG uređivač, Markdown, HTML ili običan tekst te predlošci u jeziku Go s više od 100 funkcija.
• Statistika: otvaranja, klikovi, odbijene poruke i najpraćenije poveznice, kampanju po kampanju.
• Transakcijske poruke: API za slanje poruke prema predlošku, na primjer potvrde narudžbe. „Messengeri” u obliku HTTP webhooka otvaraju i SMS ili WhatsApp, za povezivanje s uslugom po vašem izboru.
• Pretplatnici: stranica na kojoj svatko upravlja svojim postavkama, izvozi svoje podatke ili ih briše.
• Tim: precizne uloge i dozvole, jedinstvena prijava OIDC i ograničeni API tokeni.
• Mediji: knjižnica slika na disku ili na pohrani kompatibilnoj sa S3.

Što dopušta licenca AGPL-3.0

Listmonk je objavljen pod licencom GNU AGPL, inačica 3. Možete ga koristiti, i u tvrtki, te slati svoje kampanje i kampanje svojih klijenata, bez kupnje licence. Ostaju trošak poslužitelja i trošak vaše usluge slanja.

Članak 13. dodaje uvjet svojstven licenci AGPL: ako program izmijenite, vaša inačica mora jasno ponuditi svima koji je koriste na daljinu, preko mreže, da besplatno dobiju njezin izvorni kod. Ako distribuirate kopije, primjenjuju se i obveze licence o dijeljenju koda. Pokretanje Listmonka bez izmjena ne aktivira taj članak.

Koju inačicu Listmonka instalirati?

Jedna stvar koju treba znati prije početka. Na GitHubu oznaka „Latest” trenutačno označuje v7.0.0-beta.2 od 10. studenoga 2026., koju sam projekt predstavlja kao betu. Posljednja stabilna inačica je v6.2.0, koja nosi sigurnosne ispravke dozvola. Na dan 11. studenoga 2026. Docker slika latest označuje tu v6.2.0.

Inačica 7 zamjenjuje cijelo administracijsko sučelje, mijenja neke njegove adrese, postavku app.from_email pretvara u popis adresa i mijenja ključeve prijevoda, što utječe na prilagođene predloške. Pročitajte njezine bilješke o izdanju prije prelaska.

Compose datoteka projekta pokreće --upgrade --yes pri svakom pokretanju: nova slika migrira bazu bez pitanja. Migrirana se baza ne može čitati starijom inačicom, a povratak unatrag zahtijeva vraćanje sigurnosne kopije. S fiksnom oznakom, poput v6.2.0, promjena inačice ostaje vaša odluka.

Instalacija s Docker Composeom

Projekt preporučuje Docker Compose: njegova datoteka zajedno pokreće Listmonk i PostgreSQL. Na poslužitelju s instaliranim Dockerom izradite mapu i preuzmite tu datoteku:

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

Projekt traži da datoteku prilagodite svojem okruženju. Evo jedinih redaka koje treba promijeniti, ostalo se ne dira:

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

• Lozinka baze: datoteka kao početnu vrijednost daje listmonk. Promijenite je prije prvog pokretanja, jer PostgreSQL slika čita ovu varijablu samo na praznoj mapi s podacima.
• Slika: određena inačica umjesto latest, iz gore navedenog razloga.
• Port objavljen na 127.0.0.1: to je naša prilagodba. Datoteka projekta objavljuje port 9000 bez ograničenja adrese, a PostgreSQL već ograničava na lokalnu adresu. Tretiran na isti način, Listmonk je dostupan samo preko obrnutog proxyja.
• Naziv hosta: datoteka savjetuje puni naziv domene.

Zatim pokrenite usluge, unaprijed izradivši račun Super Admin. Ove dvije varijable služe samo pri prvom pokretanju, a bez njih se račun izrađuje pri prvom posjetu sučelju: bolje da postoji prije otvaranja vaše domene.

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

Bez Dockera: binarna datoteka

Listmonk radi i kao samostalni program, uz vaš vlastiti PostgreSQL poslužitelj, inačice 12 ili novije, na kojem je baza već izrađena.

1. Preuzmite arhivu inačice v6.2.0 sa stranice izdanja projekta, na primjer listmonk_6.2.0_linux_amd64.tar.gz, izbjegavajući betu prikazanu na vrhu, i raspakirajte binarnu datoteku.
2. Generirajte konfiguracijsku datoteku, a zatim u config.toml upišite pristupne podatke baze.
3. Instalirajte tablice, a zatim pokrenite Listmonk.

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

Prema zadanim postavkama config.toml sluša na localhost:9000, što odgovara radu iza obrnutog proxyja. Repozitorij daje datoteku usluge listmonk@.service za systemd.

Veličina poslužitelja

Web-stranica projekta navodi produkcijsku instancu koja šalje kampanju od više od 7 milijuna e-poruka s djelićem jedne procesorske jezgre i vrhuncem od 57 MB memorije. Ne objavljuje ni minimum ni brojku za PostgreSQL, čiji se opseg povećava s vašim pretplatnicima, otvaranjima i klikovima. Na Managed VPS-u opišite nam svoju upotrebu, a mi vam preporučujemo odgovarajuću veličinu.

HTTPS i obrnuti proxy

Vaši pretplatnici klikaju na poveznice koje vode na vašu instancu: odjava, potvrda, praćenje klikova. Stoga se poslužuje preko HTTPS-a na vlastitom nazivu domene. Izradite A i AAAA zapise tog naziva prema svojem poslužitelju, na koji posjetitelji stižu na portovima 80 i 443. Dokumentacija Listmonka prepušta izbor proxyja vama, evo dvije uobičajene konfiguracije.

S Caddyjem

Caddy sam pribavlja i obnavlja certifikat:

listmonk.example.com {
    reverse_proxy 127.0.0.1:9000
}

S Nginxom i Certbotom

Nginx prema zadanim postavkama odbija zahtjeve veće od 1 MB, s pogreškom 413. Za uvoz datoteke s pretplatnicima ili slika podignite to ograničenje prema veličini svojih datoteka:

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

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

Prve postavke

Prijavite se na https://listmonk.example.com/admin, a zatim otvorite „Settings”:

• „General”, „Root URL”: javna adresa vaše instance, bez završne kose crte, poput https://listmonk.example.com. Listmonk iz nje gradi poveznice za odjavu, potvrdu i praćenje u vašim porukama. Njezina početna vrijednost, http://localhost:9000, ne bi radila kod vaših pretplatnika.
• „General”, „Default from email”: zadana adresa pošiljatelja, na vašoj domeni, umjesto ponuđenog primjera.
• „Media”, „Upload path”: /listmonk/uploads, mapa koju Compose datoteka montira na poslužitelju.
• „General”: javna stranica za pretplatu i javni arhiv aktivni su na početku. Zadržite ih ako vam trebaju.
• „Security”, „Enable CAPTCHA”: na početku je isključen, a štiti javni obrazac za pretplatu.

Što ostaje javno, a što se može zatvoriti

Za filtriranje pristupa, prema IP adresi ili preko proxyja za autentifikaciju, dokumentacija rute dijeli ovako:

Slanje: Listmonk koristi vaše SMTP poslužitelje

Listmonk priprema i usklađuje tempo vaših poruka, a zatim ih povjerava SMTP poslužiteljima koje deklarirate u „Settings”, „SMTP”. Sam ih ne isporučuje u sandučiće vaših pretplatnika: kvaliteta isporuke stoga ovisi o tom poslužitelju, vašoj domeni i vašim popisima.

Za masovno slanje odaberite specijaliziranu uslugu slanja: ona nosi reputaciju vaših slanja i potpise vaše domene te zna vratiti odbijene poruke. S Simafri VPS-a slanje ide preko autentificiranog SMTP releja, na portu 587: ovdje onog te usluge.

Za orijentaciju, dokumentacija Listmonka opisuje odbijene poruke za Amazon SES, Azure Communication Services, SendGrid, Postmark, Forward Email i Lettermint. Usporedite ih prema svojem opsegu i primateljima.

Zatim kliknite „Test connection”: Listmonk šalje probnu poruku i prikazuje pogrešku poslužitelja ako slanje ne uspije. Možete deklarirati više poslužitelja, odabrati jedan od njih po kampanji ili usmjeravati slanja prema adresi ili domeni pošiljatelja.

Brzina slanja

Podesite je u „Settings”, „Performance”, ispod ograničenja vaše usluge:

• „Concurrency” i „Message rate”: broj niti za slanje i poruka u sekundi za svaku. Početne vrijednosti, 10 i 10, dopuštaju do 100 poruka u sekundi.
• „Batch size”: broj pretplatnika pročitanih iz baze pri svakom prolazu, na početku 1000, koji treba držati iznad ciljane brzine. Viši troši više memorije.
• „Enable sliding window limit”: gornja granica poruka u određenom razdoblju, korisna kada vaša usluga broji po satu.
• „Maximum error threshold”: broj pogrešaka nakon kojeg se kampanja pauzira.

Poruka koja ne uspije ponovno se pokušava prema postavci „Retries”, na drugim vezama poslužitelja. Ako ponovno ne uspije, Listmonk je bilježi kao pogrešku i prelazi na sljedeću: pratite te pogreške tijekom velike kampanje.

Isporučivost, odjava i privola

Hostanje aplikacije na vlastitom poslužitelju ostavlja vas gospodarom tih tema, a one odlučuju stižu li vaše poruke.

SPF, DKIM i DMARC

Šaljite s adrese svoje domene i u njezinu DNS zonu objavite SPF i DKIM zapise koje vam daje vaša usluga slanja, uz DMARC zapis. Google traži sva tri od pošiljatelja s više od 5000 poruka dnevno prema Gmail računima, uz domenu slanja usklađenu sa SPF-om ili DKIM-om, odjavu jednim klikom za marketinške poruke i stopu prijava spama ispod 0,30 %, idealno ispod 0,10 %.

Odjava

• U poruci: stavite {{ UnsubscribeURL }} u podnožje svojeg predloška. Ta poveznica vodi na upravljanje postavkama i odjavu.
• U zaglavljima: opcija „Include List-Unsubscribe header” u „Settings”, „Privacy”, aktivna na početku, omogućuje programima za e-poštu da ponude odjavu jednim klikom.
• Podaci: ista stranica postavki pretplatniku daje pravo da izveze svoje podatke, izbriše ih i stavi se na popis blokiranih. Te su opcije aktivne na početku.

Privola vaših primatelja

Listmonk primjenjuje vrstu popisa koju odaberete. Na popisu s jednostrukom potvrdom (simple opt-in) pretplatnik dodan bez potvrde ipak prima vaše kampanje. Na popisu s dvostrukom potvrdom (double opt-in) prvo dobiva poruku za potvrdu, a vaše kampanje primaju samo potvrđeni pretplatnici. To je izbor koji najbolje štiti vašu reputaciju slanja i čuva jasan trag pristanka.

Pravila ovise o zemlji vaših primatelja. U Francuskoj, na primjer, CNIL traži prethodnu privolu pojedinaca, pozitivnom radnjom poput neoznačene kućice, uz iznimku za vaše klijente za slične proizvode ili usluge. Među poslovnim subjektima promidžba se može temeljiti na legitimnom interesu ako se odnosi na njihovu djelatnost. U svakom slučaju svaka poruka navodi pošiljatelja i nudi jednostavan način odbijanja sljedećih.

Pišite samo osobama koje očekuju vaše poruke. Kupljeni ili stari popis povećava odbijene poruke i prijave spama, a posljedice snosi vaša domena.

Praćenje otvaranja i klikova

Piksel za praćenje i praćenje klikova zadiru u privatnost, a dokumentacija traži da ih koristite uz poštovanje pravila poput GDPR-a. Prema zadanim postavkama to praćenje nije vezano uz svakog pretplatnika: opcija „Individual subscriber tracking” veže ga, a „Disable tracking” potpuno ga isključuje, u „Settings”, „Privacy”.

Odbijene poruke

Nastavak pisanja na adresu koja odbija vaše poruke šteti vašoj reputaciji slanja. Obrada odbijenih poruka isključena je na početku: uključite je u „Settings”, „Bounces”, a zatim odaberite jedan od ova dva puta.

• Webhook vaše usluge slanja: uključite „Enable bounce webhooks” i opciju svoje usluge. Listmonk prima odbijene poruke od SES-a, Azure Communication Services, SendGrida, Postmarka, Forward Emaila i Letterminta na adresi poput https://listmonk.example.com/webhooks/service/ses, pri čemu se posljednja riječ mijenja prema usluzi. Ta adresa mora ostati javna.
• POP3 sandučić: Listmonk ponovno čita sandučić koji prima odbijene poruke, onaj vaše adrese pošiljatelja ili namjenski. Vrstu odbijanja tada pogađa prema sadržaju poruke, a ono što ne prepozna smatra blagim.

Za namjenski sandučić deklarirajte ga kao povratnu adresu u „Settings”, „SMTP”, „Custom headers”:

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

Početne postavke su one koje dokumentacija daje za SES i čine dobru osnovu:

PostgreSQL, jedina ovisnost

Listmonk traži PostgreSQL 12 ili noviji. Compose datoteka donosi postgres:17-alpine, s podacima u Docker volumenu listmonk-data. Pretplatnici, kampanje, predlošci, statistika i većina postavki žive u njemu; u konfiguraciji ostaju samo pristupni podaci baze i adresa slušanja.

Da biste ciljali postojeći PostgreSQL poslužitelj, izmijenite varijable LISTMONK_db__host, LISTMONK_db__port, LISTMONK_db__user, LISTMONK_db__password i LISTMONK_db__database usluge app.

Listmonk je osmišljen za velike popise. Kako baza raste, ona može usporiti sučelje: s milijunima pretplatnika nadzorna ploča i brojači mogu se prikazivati desecima sekundi. Projekt tada savjetuje dva postupka:

• „Cache slow database queries”, u „Settings”, „Performance”: brojači se računaju u redovitim razmacima, prema zadanim postavkama svake noći u 3 sata.
• VACUUM ANALYZE na velikoj bazi, na primjer svakog tjedna. Naredba blokira upite za vrijeme izvođenja, obično nekoliko sekundi.

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

Sigurnosne kopije i ažuriranja

Vašu instancu čine dva elementa: baza PostgreSQL i mapa uploads, ako vaše slike ostaju na disku. pg_dump proizvodi dosljedan izvoz bez zaustavljanja Listmonka i bez blokiranja ostalih pristupa bazi:

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

Za vraćanje zaustavite Listmonk, ispraznite bazu, a zatim ponovno učitajte izvoz. Kako navodi dokumentacija, ta radnja briše postojeću bazu:

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

Ažuriranje

1. Pročitajte bilješke nove inačice: Listmonk vas u svojem sučelju upozorava na nove inačice, a neke sadrže sigurnosne ispravke.
2. Izvezite bazu, kako projekt traži prije svakog ažuriranja.
3. Promijenite oznaku slike u docker-compose.yml.
4. Pokrenite naredbe iz dokumentacije. Compose datoteka migrira bazu pri pokretanju.

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

S binarnom datotekom zaustavite Listmonk, zamijenite binarnu datoteku, pokrenite ./listmonk --upgrade, a zatim ga ponovno pokrenite. Za povratak na raniju inačicu vratite izvoz napravljen prije ažuriranja, a zatim vratite staru oznaku.

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; Listmonk ostaje vaš softver, sa svojim postavkama, vašim popisima i vašim kampanjama.

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.