Hostovanie Listmonk na Managed VPS: vaše newslettery na vašom serveri

Čo Listmonk robí

Listmonk spravuje vaše zoznamy adresátov a newslettery z webového rozhrania. Je to jediný program, napísaný v jazyku Go, ktorého jedinou závislosťou je PostgreSQL. Jeho zoznamy sú jednosmerné: píšete svojim odberateľom a nejde o diskusný zoznam medzi nimi.

• Zoznamy: zoznamy so single alebo double opt-in, až po milióny odberateľov, a segmentácia výrazmi SQL podľa ich atribútov.
• Kampane: vizuálny editor ťahaním, editor WYSIWYG, Markdown, HTML alebo čistý text a šablóny v jazyku Go s viac než 100 funkciami.
• Štatistiky: otvorenia, kliknutia, odrazené e-maily a najsledovanejšie odkazy, kampaň po kampani.
• Transakčné správy: API na odoslanie správy podľa šablóny, napríklad potvrdenia objednávky. „Messengery“ cez webhook HTTP otvárajú aj SMS alebo WhatsApp, na pripojenie k službe podľa vášho výberu.
• Odberatelia: stránka, kde každý spravuje svoje preferencie, exportuje svoje údaje alebo ich vymaže.
• Tím: podrobné roly a oprávnenia, jednotné prihlasovanie OIDC a obmedzené tokeny API.
• Médiá: knižnica obrázkov na disku alebo na úložisku kompatibilnom so S3.

Čo umožňuje licencia AGPL-3.0

Listmonk vychádza pod licenciou GNU AGPL verzia 3. Môžete ho používať, aj vo firme, a odosielať svoje kampane aj kampane svojich zákazníkov, bez licencie, ktorú by ste museli kupovať. Zostáva náklad na server a na vašu odosielaciu službu.

Článok 13 dopĺňa podmienku vlastnú AGPL: ak program upravíte, vaša verzia musí všetkým, ktorí ju používajú na diaľku, cez sieť, jasne ponúknuť možnosť získať jej zdrojový kód zadarmo. Ak šírite kópie, uplatňujú sa aj povinnosti licencie týkajúce sa zdieľania kódu. Prevádzkovanie Listmonk bez úprav tento článok nespúšťa.

Ktorú verziu Listmonk nainštalovať?

Jedna vec, ktorú treba vedieť pred začiatkom. Na GitHube označuje značka „Latest“ momentálne verziu v7.0.0-beta.2 z 10. novembra 2026, ktorú projekt sám predstavuje ako betu. Posledná stabilná verzia je v6.2.0, ktorá obsahuje bezpečnostné opravy oprávnení. K 11. novembru 2026 označuje obraz Docker latest túto verziu v6.2.0.

Verzia 7 nahrádza celé administračné rozhranie, mení niektoré jeho adresy, robí z nastavenia app.from_email zoznam adries a upravuje kľúče prekladov, čo sa dotýka vlastných šablón. Pred prechodom si prečítajte jej poznámky k vydaniu.

Súbor Compose projektu spúšťa pri každom štarte --upgrade --yes: nový obraz migruje databázu bez opýtania. Migrovanú databázu však staršia verzia už neprečíta a návrat späť vyžaduje obnovu zo zálohy. S pevnou značkou, ako v6.2.0, zostáva zmena verzie vaším rozhodnutím.

Inštalácia pomocou Docker Compose

Projekt odporúča Docker Compose: jeho súbor spúšťa Listmonk a PostgreSQL spolu. Na serveri s nainštalovaným Dockerom vytvorte priečinok a stiahnite tento súbor:

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

Projekt žiada prispôsobiť tento súbor vášmu prostrediu. Toto sú jediné riadky na zmenu, zvyšok sa nemení:

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

• Heslo databázy: súbor dodáva ako východiskovú hodnotu listmonk. Zmeňte ho pred prvým spustením, pretože obraz PostgreSQL číta túto premennú len pri prázdnom dátovom priečinku.
• Obraz: konkrétna verzia namiesto latest, z dôvodu uvedeného vyššie.
• Port publikovaný na 127.0.0.1: je to naša úprava. Súbor projektu publikuje port 9000 bez obmedzenia adresy a PostgreSQL už obmedzuje na lokálnu adresu. Ak sa s Listmonk naloží rovnako, je dostupný jedine cez reverznú proxy.
• Názov hostiteľa: súbor odporúča plne kvalifikované doménové meno.

Potom spustite služby a vopred vytvorte účet Super Admin. Tieto dve premenné slúžia len pri prvom spustení a bez nich sa účet vytvorí pri prvej návšteve rozhrania: radšej nech existuje skôr, než otvoríte svoju doménu.

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

Bez Dockeru: binárny súbor

Listmonk beží aj ako samostatný program, vedľa vášho vlastného servera PostgreSQL vo verzii 12 alebo novšej, kde je databáza už vytvorená.

1. Stiahnite archív verzie v6.2.0 zo stránky vydaní projektu, napríklad listmonk_6.2.0_linux_amd64.tar.gz, vyhnite sa bete zobrazenej navrchu a rozbaľte binárny súbor.
2. Vygenerujte konfiguračný súbor a potom vyplňte prístupové údaje k databáze v config.toml.
3. Nainštalujte tabuľky a potom spustite Listmonk.

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

Predvolene config.toml počúva na localhost:9000, čo vyhovuje za reverznou proxy. Repozitár poskytuje súbor služby listmonk@.service pre systemd.

Veľkosť servera

Web projektu uvádza produkčnú inštanciu, ktorá odosiela kampaň s viac než 7 miliónmi e-mailov so zlomkom jadra procesora a špičkou 57 MB pamäte. Neuvádza ani minimum, ani číslo pre PostgreSQL, ktorého objem rastie s vašimi odberateľmi, otvoreniami a kliknutiami. Na spravovanom VPS (Managed VPS) nám opíšte svoje použitie a odporučíme vám vhodnú veľkosť.

HTTPS a reverzná proxy

Vaši odberatelia klikajú na odkazy smerujúce na vašu inštanciu: odhlásenie, potvrdenie, sledovanie kliknutí. Obsluhuje sa preto cez HTTPS na vlastnom doménovom mene. Vytvorte záznamy A a AAAA tohto mena smerujúce na váš server, kam návštevníci prichádzajú na porty 80 a 443. Dokumentácia Listmonk necháva výber proxy na vás, tu sú dve bežné konfigurácie.

S Caddy

Caddy získava a obnovuje certifikát sám:

listmonk.example.com {
    reverse_proxy 127.0.0.1:9000
}

S Nginx a Certbotom

Nginx predvolene odmieta požiadavky väčšie ako 1 MB, s chybou 413. Na import súboru odberateľov alebo obrázkov zvýšte tento limit podľa veľkosti svojich súborov:

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 potom nainštaluje certifikát Let’s Encrypt a presmerovanie na HTTPS a certifikát si následne obnovuje sám:

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

Prvé nastavenia

Prihláste sa na https://listmonk.example.com/admin a potom otvorte „Settings“:

• „General“, „Root URL“: verejná adresa vašej inštancie, bez koncovej lomky, ako https://listmonk.example.com. Listmonk z nej odvodzuje odkazy na odhlásenie, potvrdenie a sledovanie vo vašich e-mailoch. Jeho východisková hodnota, http://localhost:9000, by u vašich odberateľov nefungovala.
• „General“, „Default from email“: predvolená adresa odosielateľa, na vašej doméne, namiesto dodaného príkladu.
• „Media“, „Upload path“: /listmonk/uploads, priečinok, ktorý súbor Compose pripája na serveri.
• „General“: verejná stránka prihlásenia na odber a verejný archív sú na začiatku aktívne. Ponechajte ich, ak ich využijete.
• „Security“, „Enable CAPTCHA“: na začiatku vypnuté, chráni verejný formulár prihlásenia na odber.

Čo zostáva verejné a čo sa dá zatvoriť

Na filtrovanie prístupu, podľa adresy IP alebo cez autentifikačnú proxy, dokumentácia rozdeľuje trasy takto:

Odosielanie: Listmonk využíva vaše servery SMTP

Listmonk pripravuje a rozvrhuje vaše e-maily a potom ich zveruje serverom SMTP, ktoré deklarujete v „Settings“, „SMTP“. Sám ich do schránok vašich odberateľov nedoručuje: kvalita doručenia preto závisí od tohto servera, vašej domény a vašich zoznamov.

Pre hromadné odosielanie zvoľte špecializovanú odosielaciu službu: nesie reputáciu vašich odosielaní a podpisy vašej domény a vie hlásiť odrazené e-maily. Z VPS Simafri odosielanie prechádza cez overené relé SMTP na porte 587: tu je to relé tejto služby.

Na orientáciu dokumentácia Listmonk opisuje odrazené e-maily z Amazon SES, Azure Communication Services, SendGrid, Postmark, Forward Email a Lettermint. Porovnajte ich podľa svojho objemu a adresátov.

Potom kliknite na „Test connection“: Listmonk odošle skúšobnú správu a zobrazí chybu servera, ak odoslanie zlyhá. Môžete deklarovať viacero serverov, jeden z nich zvoliť pre kampaň alebo smerovať odosielania podľa adresy či domény odosielateľa.

Priepustnosť

Nastavte ju v „Settings“, „Performance“, pod limitom vašej služby:

• „Concurrency“ a „Message rate“: počet odosielacích vlákien a správ za sekundu pre každé. Východiskové hodnoty, 10 a 10, umožňujú až 100 správ za sekundu.
• „Batch size“: počet odberateľov načítaných z databázy pri každom prechode, na začiatku 1 000, ponechajte nad cieľovou priepustnosťou. Vyššia hodnota spotrebúva viac pamäte.
• „Enable sliding window limit“: strop správ za určité obdobie, užitočný, keď vaša služba počíta po hodinách.
• „Maximum error threshold“: počet chýb, po ktorom sa kampaň pozastaví.

Správa, ktorá zlyhá, sa podľa nastavenia „Retries“ skúša znova na iných spojeniach servera. Ak zlyhá aj naďalej, Listmonk ju zaznamená ako chybu a prejde na ďalšiu: pri veľkej kampani tieto chyby sledujte.

Doručiteľnosť, odhlásenie a súhlas

Hostovanie aplikácie vám dáva do rúk tieto témy a práve tie rozhodujú, či vaše e-maily dorazia.

SPF, DKIM a DMARC

Odosielajte z adresy svojej domény a v jej zóne DNS zverejnite záznamy SPF a DKIM, ktoré vám dá vaša odosielacia služba, spolu so záznamom DMARC. Google žiada všetky tri od odosielateľov viac než 5 000 správ denne na účty Gmail, s odosielacou doménou zosúladenou so SPF alebo DKIM, odhlásením jedným kliknutím pri marketingových správach a mierou hlásenia spamu pod 0,30 %, ideálne pod 0,10 %.

Odhlásenie

• V správe: umiestnite {{ UnsubscribeURL }} do päty svojej šablóny. Tento odkaz vedie na správu preferencií a odhlásenie.
• V hlavičkách: voľba „Include List-Unsubscribe header“ v „Settings“, „Privacy“, na začiatku aktívna, umožňuje poštovým programom ponúknuť odhlásenie jedným kliknutím.
• Údaje: tá istá stránka nastavení necháva odberateľovi právo exportovať svoje údaje, vymazať ich a zaradiť sa na zoznam blokovaných. Tieto voľby sú na začiatku aktívne.

Súhlas vašich adresátov

Listmonk uplatňuje typ zoznamu, ktorý zvolíte. Na zozname so single opt-in odberateľ pridaný bez potvrdenia vaše kampane aj tak dostáva. Na zozname s double opt-in dostane najprv potvrdzovací e-mail a vaše kampane dostávajú len potvrdení odberatelia. Je to voľba, ktorá najlepšie chráni vašu odosielaciu reputáciu a uchováva jasnú stopu súhlasu.

Pravidlá závisia od krajiny vašich adresátov. Vo Francúzsku napríklad CNIL žiada predchádzajúci súhlas fyzických osôb, pozitívnym úkonom, ako je nezaškrtnuté políčko, s výnimkou pre vašich zákazníkov pri podobných produktoch alebo službách. Medzi profesionálmi sa prospekcia môže opierať o oprávnený záujem, ak sa týka ich povolania. V každom prípade každá správa identifikuje odosielateľa a ponúka jednoduchý spôsob, ako odmietnuť ďalšie.

Píšte len ľuďom, ktorí vaše správy očakávajú. Zakúpený alebo starý zoznam zvyšuje počet odrazených e-mailov a hlásení spamu a dôsledky nesie vaša doména.

Sledovanie otvorení a kliknutí

Sledovací pixel a sledovanie kliknutí sa dotýkajú súkromia a dokumentácia žiada používať ich v súlade s pravidlami, ako je GDPR. Predvolene toto sledovanie nie je viazané na jednotlivých odberateľov: voľba „Individual subscriber tracking“ ho viaže a „Disable tracking“ ho úplne vypína, v „Settings“, „Privacy“.

Odrazené e-maily

Pokračovať v písaní na adresu, ktorá vaše správy odmieta, poškodzuje vašu odosielaciu reputáciu. Spracovanie odrazených e-mailov je na začiatku vypnuté: zapnite ho v „Settings“, „Bounces“ a potom zvoľte jednu z týchto dvoch ciest.

• Webhook vašej odosielacej služby: zapnite „Enable bounce webhooks“ a voľbu svojej služby. Listmonk prijíma odrazené e-maily zo SES, Azure Communication Services, SendGrid, Postmark, Forward Email a Lettermint na adrese ako https://listmonk.example.com/webhooks/service/ses, pričom posledné slovo sa mení podľa služby. Táto adresa musí zostať verejná.
• Schránka POP3: Listmonk znova číta schránku, ktorá prijíma odrazené e-maily, tú vašej adresy odosielateľa alebo vyhradenú. Typ odrazenia potom odhaduje z obsahu správy a čo nerozpozná, považuje za ľahké.

Pre vyhradenú schránku ju deklarujte ako návratovú adresu v „Settings“, „SMTP“, „Custom headers“:

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

Východiskové nastavenia sú tie, ktoré dokumentácia uvádza pre SES, a tvoria dobrý základ:

PostgreSQL, jediná závislosť

Listmonk vyžaduje PostgreSQL 12 alebo novší. Súbor Compose prináša postgres:17-alpine, s údajmi v zväzku Docker listmonk-data. Odberatelia, kampane, šablóny, štatistiky a väčšina nastavení žijú tam; v konfigurácii zostávajú len prístupové údaje k databáze a adresa počúvania.

Ak chcete mieriť na existujúci server PostgreSQL, upravte premenné LISTMONK_db__host, LISTMONK_db__port, LISTMONK_db__user, LISTMONK_db__password a LISTMONK_db__database služby app.

Listmonk je navrhnutý pre veľké zoznamy. S rastom databázy môže práve ona spomaľovať rozhranie: pri miliónoch odberateľov sa môže zobrazenie dashboardu a počítadiel natiahnuť na desiatky sekúnd. Projekt potom radí dva kroky:

• „Cache slow database queries“, v „Settings“, „Performance“: počítadlá sa vypočítavajú v pravidelných intervaloch, predvolene každú noc o 3:00.
• VACUUM ANALYZE na veľkej databáze, napríklad každý týždeň. Príkaz počas svojho behu blokuje dotazy, spravidla niekoľko sekúnd.

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

Zálohy a aktualizácie

Vašu inštanciu tvoria dva prvky: databáza PostgreSQL a priečinok uploads, ak vaše obrázky zostávajú na disku. pg_dump vytvorí konzistentný export bez zastavenia Listmonk a bez blokovania ostatných prístupov k databáze:

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

Na obnovu zastavte Listmonk, vyprázdnite databázu a znova načítajte export. Ako upresňuje dokumentácia, tento krok vymaže existujúcu databázu:

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

Aktualizácia

1. Prečítajte si poznámky k novej verzii: Listmonk vás na nové verzie upozorňuje vo svojom rozhraní a niektoré obsahujú bezpečnostné opravy.
2. Exportujte databázu, ako projekt žiada pred každou aktualizáciou.
3. Zmeňte značku obrazu v docker-compose.yml.
4. Spustite príkazy z dokumentácie. Súbor Compose migruje databázu pri štarte.

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

S binárnym súborom zastavte Listmonk, nahraďte binárny súbor, spustite ./listmonk --upgrade a potom ho znova spustite. Na návrat k staršej verzii obnovte export urobený pred aktualizáciou a potom vráťte starú značku.

Kto čo robí na Managed VPS

Hostovanie na vlastnom serveri vyžaduje popri aplikácii starať sa aj o server. Na Managed VPS preberajú server naše tímy a vašu inštanciu proaktívne sledujú; Listmonk zostáva vaším softvérom, s vašimi nastaveniami, zoznamami a kampaňami.

Ak by ste uprednostnili, aby naše tímy zasiahli priamo v aplikácii, táto služba sa fakturuje hodinovo alebo paušálne, s cenovou ponukou oznámenou pred zásahom.