Hostovat Listmonk na Managed VPS: vaše newslettery na vašem serveru

Co Listmonk umí

Listmonk spravuje vaše rozesílací seznamy a newslettery z webového rozhraní. Je to jediný program napsaný v Go, jehož jedinou závislostí je PostgreSQL. Jeho seznamy jsou jednosměrné: píšete svým odběratelům, nejde o diskusní seznam mezi nimi.

• Seznamy: seznamy se single nebo double opt-inem, až po miliony odběratelů, a segmentace pomocí výrazů SQL nad jejich atributy.
• Kampaně: vizuální editor přetahováním, editor WYSIWYG, Markdown, HTML nebo prostý text a šablony v jazyce Go s více než 100 funkcemi.
• Statistiky: otevření, kliknutí, návratky a nejsledovanější odkazy, kampaň po kampani.
• Transakční zprávy: API pro odeslání zprávy podle šablony, například potvrzení objednávky. „Messengery“ přes webhook HTTP otevírají také SMS nebo WhatsApp, k napojení na službu podle vašeho výběru.
• Odběratelé: stránka, kde každý spravuje své předvolby, exportuje svá data nebo je maže.
• Tým: přesné role a oprávnění, jednotné přihlášení OIDC a omezené tokeny API.
• Média: knihovna obrázků na disku nebo na úložišti kompatibilním s S3.

Co dovoluje licence AGPL-3.0

Listmonk je vydáván pod licencí GNU AGPL verze 3. Můžete ho používat, i ve firmě, a odesílat své kampaně i kampaně svých zákazníků, aniž byste kupovali licenci. Zbývají náklady na server a na vaši odesílací službu.

Článek 13 přidává podmínku specifickou pro AGPL: pokud program upravíte, musí vaše verze všem, kdo ji používají na dálku přes síť, jasně nabídnout možnost získat její zdrojový kód zdarma. Pokud šíříte kopie, platí také povinnosti licence týkající se sdílení kódu. Provozování Listmonk bez úprav tento článek nespouští.

Kterou verzi Listmonk nainstalovat?

Bod, který je třeba znát před začátkem. Na GitHubu označuje štítek „Latest“ v tuto chvíli verzi v7.0.0-beta.2 z 10. listopadu 2026, kterou projekt sám představuje jako betu. Poslední stabilní verzí je v6.2.0, která obsahuje bezpečnostní opravy oprávnění. K 11. listopadu 2026 označuje obraz Docker latest právě tuto v6.2.0.

Verze 7 nahrazuje celé administrační rozhraní, mění některé jeho adresy, z nastavení app.from_email dělá seznam adres a upravuje klíče překladů, což se dotýká vlastních šablon. Než na ni přejdete, přečtěte si její poznámky k vydání.

Soubor Compose projektu spouští --upgrade --yes při každém startu: nový obraz zmigruje databázi, aniž by se vás zeptal. Zmigrovanou databázi ale starší verze znovu nepřečte a návrat zpět vyžaduje obnovit zálohu. S pevnou značkou, například v6.2.0, zůstává změna verze vaším rozhodnutím.

Instalace pomocí Docker Compose

Projekt doporučuje Docker Compose: jeho soubor spouští Listmonk a PostgreSQL společně. Na serveru s nainstalovaným Dockerem vytvořte složku a stáhněte tento soubor:

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

Projekt žádá přizpůsobit tento soubor vašemu prostředí. Zde jsou jediné řádky ke změně, zbytek se nemění:

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áze: soubor jako výchozí hodnotu uvádí listmonk. Změňte ho před prvním spuštěním, protože obraz PostgreSQL tuto proměnnou čte jen u prázdné složky s daty.
• Obraz: konkrétní verze místo latest, z důvodu uvedeného výše.
• Port publikovaný na 127.0.0.1: to je naše úprava. Soubor projektu publikuje port 9000 bez omezení adres a PostgreSQL už omezuje na lokální adresu. Při stejném zacházení je Listmonk dostupný jen přes reverzní proxy.
• Název hostitele: soubor radí úplné doménové jméno.

Poté spusťte služby a účet Super Admin vytvořte předem. Tyto dvě proměnné slouží jen při prvním spuštění a bez nich se účet vytvoří při první návštěvě rozhraní: ať raději existuje dřív, než otevřete svou doménu.

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

Bez Dockeru: binární soubor

Listmonk běží také jako samostatný program, vedle vašeho vlastního serveru PostgreSQL ve verzi 12 nebo vyšší, kde je databáze již vytvořena.

1. Stáhněte archiv verze v6.2.0 ze stránky vydání projektu, například listmonk_6.2.0_linux_amd64.tar.gz, a vyhněte se betě zobrazené nahoře, a rozbalte binární soubor.
2. Vygenerujte konfigurační soubor a pak vyplňte přístupové údaje k databázi v config.toml.
3. Nainstalujte tabulky a pak spusťte Listmonk.

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

Ve výchozím nastavení config.toml naslouchá na localhost:9000, což se hodí za reverzní proxy. Repozitář poskytuje soubor služby listmonk@.service pro systemd.

Velikost serveru

Web projektu uvádí produkční instanci, která odesílá kampaň s více než 7 miliony e-mailů se zlomkem jednoho jádra procesoru a špičkou 57 MB paměti. Neuvádí žádné minimum ani číslo pro PostgreSQL, jehož objem roste s vašimi odběrateli, otevřeními a kliknutími. Na Managed VPS nám popište své využití a doporučíme vám vhodnou velikost.

HTTPS a reverzní proxy

Vaši odběratelé klikají na odkazy, které vedou na vaši instanci: odhlášení, potvrzení, sledování kliknutí. Provozuje se proto přes HTTPS na vlastním doménovém jménu. Vytvořte pro toto jméno záznamy A a AAAA směřující na váš server, kde návštěvníci přicházejí na porty 80 a 443. Dokumentace Listmonk volbu proxy ponechává na vás, zde jsou dvě běžné konfigurace.

S Caddy

Caddy si certifikát získává a obnovuje sám:

listmonk.example.com {
    reverse_proxy 127.0.0.1:9000
}

S Nginx a Certbotem

Nginx ve výchozím nastavení odmítá požadavky větší než 1 MB, s chybou 413. Pro import souboru odběratelů nebo obrázků zvyšte tento limit podle velikosti svých souborů:

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 pak nainstaluje certifikát Let’s Encrypt a přesměrování na HTTPS a certifikát poté obnovuje sám:

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

První nastavení

Přihlaste se na https://listmonk.example.com/admin a otevřete „Settings“:

• „General“, „Root URL“: veřejná adresa vaší instance, bez koncového lomítka, například https://listmonk.example.com. Listmonk z ní skládá odkazy pro odhlášení, potvrzení a sledování ve vašich e-mailech. Její výchozí hodnota, http://localhost:9000, by u vašich odběratelů nefungovala.
• „General“, „Default from email“: výchozí adresa odesílatele, na vaší doméně, místo uvedeného příkladu.
• „Media“, „Upload path“: /listmonk/uploads, složka, kterou soubor Compose připojuje na serveru.
• „General“: veřejná stránka přihlášení k odběru a veřejný archiv jsou zpočátku aktivní. Ponechte je, pokud je využijete.
• „Security“, „Enable CAPTCHA“: zpočátku vypnuto, chrání veřejný formulář přihlášení k odběru.

Co zůstává veřejné a co lze uzavřít

Pokud chcete přístup filtrovat, podle adresy IP nebo přes ověřovací proxy, dokumentace rozděluje cesty takto:

Odesílání: Listmonk prochází vašimi servery SMTP

Listmonk připravuje a dávkuje vaše e-maily a poté je svěřuje serverům SMTP, které deklarujete v „Settings“, „SMTP“. Sám je do schránek vašich odběratelů nedoručuje: kvalita doručení tedy závisí na tomto serveru, na vaší doméně a na vašich seznamech.

Pro hromadné odesílání zvolte specializovanou odesílací službu: nese pověst vašich odesílání a podpisy vaší domény a umí hlásit návratky. Z VPS Simafri vede odesílání přes ověřené relé SMTP na portu 587: zde relé této služby.

Pro orientaci dokumentace Listmonk popisuje návratky služeb Amazon SES, Azure Communication Services, SendGrid, Postmark, Forward Email a Lettermint. Porovnejte je podle svého objemu a příjemců.

Poté klikněte na „Test connection“: Listmonk odešle zkušební zprávu a při selhání odesílání zobrazí chybu serveru. Můžete deklarovat několik serverů, vybrat jeden z nich pro kampaň, nebo směrovat odesílání podle adresy či domény odesílatele.

Propustnost

Nastavte ji v „Settings“, „Performance“, pod limitem své služby:

• „Concurrency“ a „Message rate“: počet odesílacích vláken a počet zpráv za sekundu pro každé z nich. Výchozí hodnoty, 10 a 10, umožňují až 100 zpráv za sekundu.
• „Batch size“: počet odběratelů načtených z databáze při každém průchodu, zpočátku 1 000, který je třeba držet nad cílovou propustností. Vyšší spotřebuje více paměti.
• „Enable sliding window limit“: strop zpráv za určitou dobu, užitečný, když vaše služba počítá po hodinách.
• „Maximum error threshold“: počet chyb, po jehož překročení se kampaň pozastaví.

Zpráva, která selže, se opakuje podle nastavení „Retries“, na jiných spojeních serveru. Pokud selže znovu, Listmonk ji zaznamená jako chybu a pokračuje další: během velké kampaně tyto chyby sledujte.

Doručitelnost, odhlášení a souhlas

Vlastní hosting aplikace vám dává tato témata do rukou a právě ta rozhodují, zda vaše e-maily dorazí.

SPF, DKIM a DMARC

Odesílejte z adresy své domény a v její zóně DNS zveřejněte záznamy SPF a DKIM, které vám dá vaše odesílací služba, spolu se záznamem DMARC. Google žádá všechny tři od odesílatelů s více než 5 000 zprávami denně na účty Gmail, s odesílací doménou zarovnanou podle SPF nebo DKIM, s odhlášením jedním kliknutím u marketingových zpráv a s mírou nahlášení jako spam pod 0,30 %, ideálně pod 0,10 %.

Odhlášení

• Ve zprávě: umístěte {{ UnsubscribeURL }} do patičky své šablony. Tento odkaz vede ke správě předvoleb a k odhlášení.
• V hlavičkách: volba „Include List-Unsubscribe header“ v „Settings“, „Privacy“, zpočátku aktivní, umožňuje poštovním programům nabídnout odhlášení jedním kliknutím.
• Data: stejná stránka nastavení dává odběrateli právo exportovat svá data, smazat je a zařadit se na seznam blokovaných. Tyto volby jsou zpočátku aktivní.

Souhlas vašich příjemců

Listmonk uplatňuje typ seznamu, který zvolíte. Na seznamu se single opt-inem dostává vaše kampaně i odběratel přidaný bez potvrzení. Na seznamu s double opt-inem dostane nejdřív potvrzovací e-mail a vaše kampaně dostávají jen potvrzení odběratelé. Je to volba, která nejlépe chrání vaši odesílací pověst a uchovává jasnou stopu souhlasu.

Pravidla závisejí na zemi vašich příjemců. Ve Francii například CNIL u fyzických osob žádá předchozí souhlas, formou pozitivního úkonu, například nezaškrtnutého políčka, s výjimkou pro vaše zákazníky u podobných produktů či služeb. Mezi podnikateli se oslovování může opírat o oprávněný zájem, pokud se týká jejich profese. V každém případě každá zpráva identifikuje odesílatele a nabízí jednoduchý způsob, jak další odmítnout.

Pište jen lidem, kteří vaše zprávy očekávají. Koupený nebo starý seznam zvyšuje návratky a nahlášení jako spam a důsledky nese vaše doména.

Sledování otevření a kliknutí

Sledovací pixel a sledování kliknutí se dotýkají soukromí a dokumentace žádá používat je v souladu s pravidly, jako je GDPR. Ve výchozím nastavení toto sledování není spojeno s jednotlivými odběrateli: volba „Individual subscriber tracking“ ho spojí a „Disable tracking“ ho zcela vypne, v „Settings“, „Privacy“.

Návratky

Další psaní na adresu, která vaše zprávy odmítá, poškozuje vaši odesílací pověst. Zpracování návratek je zpočátku vypnuté: zapněte ho v „Settings“, „Bounces“ a pak zvolte jednu z těchto dvou cest.

• Webhook vaší odesílací služby: zapněte „Enable bounce webhooks“ a volbu své služby. Listmonk přijímá návratky z SES, Azure Communication Services, SendGrid, Postmark, Forward Email a Lettermint na adrese jako https://listmonk.example.com/webhooks/service/ses, přičemž poslední slovo se mění podle služby. Tato adresa musí zůstat veřejná.
• Schránka POP3: Listmonk čte schránku, která návratky přijímá, buď schránku vaší adresy odesílatele, nebo vyhrazenou. Typ návratky pak odhaduje podle obsahu zprávy a to, co nepozná, považuje za lehké.

U vyhrazené schránky ji deklarujte jako návratovou adresu v „Settings“, „SMTP“, „Custom headers“:

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

Výchozí nastavení jsou ta, která dokumentace uvádí pro SES, a tvoří dobrý základ:

PostgreSQL, jediná závislost

Listmonk vyžaduje PostgreSQL 12 nebo vyšší. Soubor Compose přináší postgres:17-alpine, s daty ve svazku Docker listmonk-data. Odběratelé, kampaně, šablony, statistiky a většina nastavení žijí v něm; v konfiguraci zůstávají jen přístupové údaje k databázi a adresa naslouchání.

Chcete-li zamířit na existující server PostgreSQL, upravte proměnné LISTMONK_db__host, LISTMONK_db__port, LISTMONK_db__user, LISTMONK_db__password a LISTMONK_db__database služby app.

Listmonk je navržen pro velké seznamy. S růstem databáze může být právě ona tím, co zpomaluje rozhraní: s miliony odběratelů může zobrazení dashboardu a počítadel trvat desítky sekund. Projekt pak radí dva kroky:

• „Cache slow database queries“, v „Settings“, „Performance“: počítadla se počítají v pravidelných intervalech, ve výchozím nastavení každou noc ve 3 hodiny.
• VACUUM ANALYZE na velké databázi, například každý týden. Příkaz po dobu svého běhu blokuje dotazy, obvykle několik sekund.

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

Zálohy a aktualizace

Vaši instanci tvoří dva prvky: databáze PostgreSQL a složka uploads, pokud vaše obrázky zůstávají na disku. pg_dump vytvoří konzistentní export bez zastavení Listmonk a bez blokování ostatních přístupů k databázi:

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

Pro obnovu zastavte Listmonk, vyprázdněte databázi a znovu načtěte export. Jak dokumentace upřesňuje, tento krok smaže stávající databázi:

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

Aktualizace

1. Přečtěte si poznámky k nové verzi: Listmonk vás na nové verze upozorňuje ve svém rozhraní a některé obsahují bezpečnostní opravy.
2. Exportujte databázi, jak projekt žádá před každou aktualizací.
3. Změňte značku obrazu v docker-compose.yml.
4. Spusťte příkazy z dokumentace. Soubor Compose zmigruje databázi při spuštění.

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

S binárním souborem Listmonk zastavte, nahraďte binární soubor, spusťte ./listmonk --upgrade a pak jej spusťte znovu. Chcete-li se vrátit ke starší verzi, obnovte export pořízený před aktualizací a poté vraťte původní značku.

Kdo co dělá na Managed VPS

Vlastní hosting vyžaduje, abyste kromě aplikace udržovali i server. Na Managed VPS se serveru ujímají naše týmy a vaši instanci proaktivně sledují; Listmonk zůstává vaším softwarem, s jeho nastavením, vašimi seznamy a kampaněmi.

Pokud dáváte přednost tomu, aby naše týmy zasáhly přímo v aplikaci, tato služba se účtuje po hodinách nebo paušálem, s cenovou nabídkou sdělenou před zásahem.