Găzduirea Listmonk pe un Managed VPS: newsletterele pe propriul server

Ce face Listmonk

Listmonk vă gestionează listele de difuzare și newsletterele dintr-o interfață web. Este un program unic, scris în Go, a cărui singură dependență este PostgreSQL. Listele sale sunt într-un singur sens: dumneavoastră le scrieți abonaților, iar ea nu este o listă de discuții între ei.

• Listele: liste cu opt-in simplu sau dublu, până la milioane de abonați, și o segmentare prin expresii SQL pe atributele lor.
• Campaniile: un editor vizual prin tragere și plasare, un editor WYSIWYG, Markdown, HTML sau text simplu, și șabloane în limbajul Go cu peste 100 de funcții.
• Statisticile: deschideri, clicuri, bounce-uri și cele mai urmărite linkuri, campanie cu campanie.
• Mesajele tranzacționale: un API pentru a trimite un mesaj pornind de la un șablon, de exemplu o confirmare de comandă. „Messengers” în webhook HTTP deschid și SMS sau WhatsApp, de conectat la serviciul ales de dumneavoastră.
• Abonații: o pagină unde fiecare își gestionează preferințele, își exportă datele sau le șterge.
• Echipa: roluri și permisiuni precise, autentificare unică OIDC și tokenuri API limitate.
• Fișierele media: o bibliotecă de imagini pe disc sau pe o stocare compatibilă S3.

Ce permite licența AGPL-3.0

Listmonk este publicat sub licența GNU AGPL versiunea 3. Îl puteți folosi, inclusiv în firmă, și vă puteți trimite campaniile, ca și pe cele ale clienților dumneavoastră, fără nicio licență de cumpărat. Rămân costul serverului și cel al serviciului dumneavoastră de trimitere.

Articolul 13 adaugă o condiție specifică AGPL: dacă modificați programul, versiunea dumneavoastră trebuie să propună în mod clar tuturor celor care îl folosesc de la distanță, prin rețea, să-i obțină codul sursă, gratuit. Dacă distribuiți copii, se aplică și obligațiile de partajare a codului din licență. Rularea Listmonk fără modificări nu declanșează acest articol.

Ce versiune de Listmonk instalați?

Un punct de știut înainte de a începe. Pe GitHub, eticheta „Latest” desemnează în prezent v7.0.0-beta.2 din 10 noiembrie 2026, pe care proiectul însuși o prezintă ca pe o beta. Ultima versiune stabilă este v6.2.0, care conține corecturi de securitate privind permisiunile. La 11 noiembrie 2026, imaginea Docker latest desemnează această v6.2.0.

Versiunea 7 înlocuiește întreaga interfață de administrare, schimbă unele dintre adresele ei, face din setarea app.from_email o listă de adrese și modifică chei de traducere, ceea ce afectează șabloanele personalizate. Citiți notele ei de versiune înainte de a trece la ea.

Fișierul Compose al proiectului rulează --upgrade --yes la fiecare pornire: o imagine nouă migrează baza fără să vă întrebe. Or, o bază migrată nu se mai citește cu o versiune mai veche, iar revenirea în urmă impune restaurarea unui backup. Cu o etichetă fixă, precum v6.2.0, schimbarea versiunii rămâne decizia dumneavoastră.

Instalarea cu Docker Compose

Proiectul recomandă Docker Compose: fișierul său pornește împreună Listmonk și PostgreSQL. Pe un server unde Docker este instalat, creați un director și descărcați acest fișier:

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

Proiectul cere adaptarea acestui fișier la mediul dumneavoastră. Iată singurele linii de schimbat, restul nu se mișcă:

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

• Parola bazei: fișierul furnizează listmonk ca valoare de pornire. Schimbați-o înainte de prima pornire, căci imaginea PostgreSQL citește această variabilă doar pe un director de date gol.
• Imaginea: o versiune precisă în locul lui latest, din motivul văzut mai sus.
• Portul publicat pe 127.0.0.1: este adaptarea noastră. Fișierul proiectului publică portul 9000 fără limită de adresă și limitează deja PostgreSQL la adresa locală. Tratat la fel, Listmonk este accesibil doar prin proxy-ul invers.
• Numele de gazdă: fișierul sfătuiește un nume de domeniu complet.

Porniți apoi serviciile, creând dinainte contul Super Admin. Aceste două variabile servesc doar la prima pornire, iar fără ele contul se creează la prima vizită a interfeței: mai bine să existe înainte de a vă deschide domeniul.

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

Fără Docker: binarul

Listmonk rulează și ca program de sine stătător, lângă propriul dumneavoastră server PostgreSQL, în versiunea 12 sau mai recentă, unde baza este deja creată.

1. Descărcați arhiva v6.2.0 de pe pagina de versiuni a proiectului, de exemplu listmonk_6.2.0_linux_amd64.tar.gz, evitând beta afișată în frunte, și extrageți binarul.
2. Generați fișierul de configurare, apoi completați accesele la bază în config.toml.
3. Instalați tabelele, apoi lansați Listmonk.

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

Implicit, config.toml ascultă pe localhost:9000, ceea ce se potrivește în spatele unui proxy invers. Depozitul furnizează un fișier de serviciu listmonk@.service pentru systemd.

Dimensiunea serverului

Site-ul proiectului citează o instanță de producție care trimite o campanie de peste 7 milioane de e-mailuri cu o fracțiune dintr-un nucleu de procesor și un vârf de 57 MB de memorie. El nu publică nici un minim, nici o cifră pentru PostgreSQL, al cărui volum crește odată cu abonații, deschiderile și clicurile dumneavoastră. Pe un Managed VPS, descrieți-ne utilizarea dumneavoastră și vă recomandăm dimensiunea potrivită.

HTTPS și proxy-ul invers

Abonații dumneavoastră dau clic pe linkuri care indică spre instanța dumneavoastră: dezabonare, confirmare, urmărirea clicurilor. Ea se servește deci în HTTPS pe propriul nume de domeniu. Creați înregistrările A și AAAA ale acestui nume către serverul dumneavoastră, unde vizitatorii ajung pe porturile 80 și 443. Documentația Listmonk lasă libertatea alegerii proxy-ului, iată două configurații uzuale.

Cu Caddy

Caddy obține și reînnoiește singur certificatul:

listmonk.example.com {
    reverse_proxy 127.0.0.1:9000
}

Cu Nginx și Certbot

Nginx refuză implicit cererile de peste 1 MB, cu o eroare 413. Pentru a importa un fișier de abonați sau imagini, ridicați această limită pe măsura fișierelor dumneavoastră:

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 instalează apoi certificatul Let’s Encrypt și redirecționarea spre HTTPS, apoi reînnoiește singur certificatul:

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

Primele setări

Conectați-vă pe https://listmonk.example.com/admin, apoi deschideți „Settings”:

• „General”, „Root URL”: adresa publică a instanței dumneavoastră, fără bară finală, precum https://listmonk.example.com. Listmonk își extrage din ea linkurile de dezabonare, de confirmare și de urmărire din e-mailurile dumneavoastră. Valoarea sa de pornire, http://localhost:9000, nu ar funcționa la abonații dumneavoastră.
• „General”, „Default from email”: adresa implicită a expeditorului, pe domeniul dumneavoastră, în locul exemplului furnizat.
• „Media”, „Upload path”: /listmonk/uploads, directorul pe care fișierul Compose îl montează pe server.
• „General”: pagina publică de abonare și arhiva publică sunt active la pornire. Păstrați-le dacă aveți nevoie de ele.
• „Security”, „Enable CAPTCHA”: dezactivat la pornire, el protejează formularul public de abonare.

Ce rămâne public, ce se poate închide

Pentru a filtra accesul, după adresa IP sau printr-un proxy de autentificare, documentația împarte rutele astfel:

Trimiterea: Listmonk trece prin serverele dumneavoastră SMTP

Listmonk pregătește și cadențează e-mailurile dumneavoastră, apoi le încredințează serverelor SMTP pe care le declarați în „Settings”, „SMTP”. El nu le livrează singur în căsuțele abonaților dumneavoastră: calitatea livrării depinde deci de acest server, de domeniul dumneavoastră și de listele dumneavoastră.

Pentru o trimitere în masă, alegeți un serviciu de trimitere specializat: el poartă reputația trimiterilor dumneavoastră și semnăturile domeniului dumneavoastră și știe să raporteze bounce-urile. De pe un VPS Simafri, trimiterea trece printr-un releu SMTP autentificat, pe portul 587: aici, cel al acestui serviciu.

Pentru orientare, documentația Listmonk descrie bounce-urile de la Amazon SES, Azure Communication Services, SendGrid, Postmark, Forward Email și Lettermint. Comparați-le în funcție de volumul și de destinatarii dumneavoastră.

Dați apoi clic pe „Test connection”: Listmonk trimite un mesaj de probă și afișează eroarea serverului dacă trimiterea eșuează. Puteți declara mai multe servere, alege unul dintre ele pentru fiecare campanie sau direcționa trimiterile după adresa sau domeniul expeditorului.

Debitul

Setați-l în „Settings”, „Performance”, sub limita serviciului dumneavoastră:

• „Concurrency” și „Message rate”: numărul de fire de trimitere și de mesaje pe secundă pentru fiecare. Valorile de pornire, 10 și 10, permit până la 100 de mesaje pe secundă.
• „Batch size”: numărul de abonați citiți din bază la fiecare trecere, 1 000 la pornire, de ținut peste debitul vizat. Mai sus, consumă mai multă memorie.
• „Enable sliding window limit”: un plafon de mesaje pe o durată, util când serviciul dumneavoastră numără pe oră.
• „Maximum error threshold”: numărul de erori peste care o campanie se pune în pauză.

Un mesaj care eșuează este reîncercat după setarea „Retries”, pe alte conexiuni ale serverului. Dacă eșuează din nou, Listmonk îl notează ca eroare și trece la următorul: urmăriți aceste erori în timpul unei campanii mari.

Livrabilitate, dezabonare și consimțământ

Găzduirea aplicației pe propriul server vă lasă stăpân pe aceste subiecte, iar ele decid dacă e-mailurile dumneavoastră ajung.

SPF, DKIM și DMARC

Trimiteți de la o adresă a domeniului dumneavoastră și publicați în zona sa DNS înregistrările SPF și DKIM pe care vi le dă serviciul dumneavoastră de trimitere, împreună cu o înregistrare DMARC. Google le cere pe toate trei expeditorilor de peste 5 000 de mesaje pe zi către conturi Gmail, cu un domeniu de expediere aliniat la SPF sau DKIM, dezabonarea cu un singur clic pentru mesajele de marketing și o rată de raportare ca spam sub 0,30 %, ideal sub 0,10 %.

Dezabonarea

• În mesaj: puneți {{ UnsubscribeURL }} în subsolul șablonului dumneavoastră. Acest link duce la gestionarea preferințelor și la dezabonare.
• În anteturi: opțiunea „Include List-Unsubscribe header” din „Settings”, „Privacy”, activă la pornire, permite programelor de e-mail să propună dezabonarea cu un singur clic.
• Datele: aceeași pagină de setări lasă abonatului dreptul de a-și exporta datele, de a le șterge și de a se pune în lista de blocare. Aceste opțiuni sunt active la pornire.

Consimțământul destinatarilor dumneavoastră

Listmonk aplică tipul de listă pe care îl alegeți. Pe o listă cu opt-in simplu, un abonat adăugat fără confirmare primește totuși campaniile dumneavoastră. Pe o listă cu double opt-in, el primește mai întâi un e-mail de confirmare, iar doar abonații confirmați primesc campaniile dumneavoastră. Este alegerea care vă protejează cel mai bine reputația de trimitere și care păstrează o urmă clară a acordului.

Regulile depind de țara destinatarilor dumneavoastră. În Franța, de exemplu, CNIL cere consimțământul prealabil al persoanelor fizice, printr-o acțiune pozitivă precum o casetă nebifată în prealabil, cu o excepție pentru clienții dumneavoastră în privința unor produse sau servicii similare. Între profesioniști, prospectarea se poate sprijini pe interesul legitim dacă privește meseria lor. În toate cazurile, fiecare mesaj identifică expeditorul și oferă un mijloc simplu de a-le refuza pe următoarele.

Scrieți doar persoanelor care așteaptă mesajele dumneavoastră. O listă cumpărată sau veche face să crească bounce-urile și raportările ca spam, iar domeniul dumneavoastră este cel care poartă consecințele.

Urmărirea deschiderilor și a clicurilor

Pixelul de urmărire și urmărirea clicurilor ating viața privată, iar documentația cere să fie folosite cu respectarea unor reguli precum RGPD. Implicit, această urmărire nu este legată de fiecare abonat: opțiunea „Individual subscriber tracking” o leagă, iar „Disable tracking” o oprește complet, în „Settings”, „Privacy”.

Bounce-urile

A continua să scrieți unei adrese care vă respinge mesajele vă strică reputația de trimitere. Tratarea bounce-urilor (mesajelor respinse) este dezactivată la pornire: activați-o în „Settings”, „Bounces”, apoi alegeți una dintre aceste două căi.

• Webhookul serviciului dumneavoastră de trimitere: activați „Enable bounce webhooks” și opțiunea serviciului dumneavoastră. Listmonk primește bounce-urile de la SES, Azure Communication Services, SendGrid, Postmark, Forward Email și Lettermint pe o adresă precum https://listmonk.example.com/webhooks/service/ses, ultimul cuvânt schimbându-se după serviciu. Această adresă trebuie să rămână publică.
• O căsuță POP3: Listmonk recitește o căsuță care primește bounce-urile, cea a adresei dumneavoastră de expediere sau o căsuță dedicată. El ghicește atunci tipul de bounce după conținutul mesajului și consideră ușor ceea ce nu recunoaște.

Pentru o căsuță dedicată, declarați-o ca adresă de retur în „Settings”, „SMTP”, „Custom headers”:

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

Setările de pornire sunt cele pe care documentația le dă pentru SES și ele formează o bază bună:

PostgreSQL, singura dependență

Listmonk cere PostgreSQL 12 sau mai recent. Fișierul Compose aduce postgres:17-alpine, cu datele în volumul Docker listmonk-data. Abonații, campaniile, șabloanele, statisticile și majoritatea setărilor trăiesc acolo; doar accesele la bază și adresa de ascultare rămân în configurație.

Pentru a viza un server PostgreSQL existent, modificați variabilele LISTMONK_db__host, LISTMONK_db__port, LISTMONK_db__user, LISTMONK_db__password și LISTMONK_db__database ale serviciului app.

Listmonk este conceput pentru liste mari. Pe măsură ce baza crește, ea este cea care poate încetini interfața: cu milioane de abonați, panoul de control și contoarele pot dura zeci de secunde să se afișeze. Proiectul sfătuiește atunci două gesturi:

• „Cache slow database queries”, în „Settings”, „Performance”: contoarele se calculează la intervale regulate, implicit în fiecare noapte la ora 3.
• VACUUM ANALYZE pe o bază mare, de exemplu în fiecare săptămână. Comanda blochează interogările pe durata trecerii sale, în general câteva secunde.

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

Backupuri și actualizări

Două elemente alcătuiesc instanța dumneavoastră: baza PostgreSQL și directorul uploads, dacă imaginile rămân pe disc. pg_dump produce un export coerent fără a opri Listmonk și fără a bloca celelalte accese la bază:

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

Pentru restaurare, opriți Listmonk, goliți baza, apoi reîncărcați exportul. După cum precizează documentația, acest gest șterge baza existentă:

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

Actualizarea

1. Citiți notele noii versiuni: Listmonk vă semnalează versiunile noi în interfața sa, iar unele conțin corecturi de securitate.
2. Exportați baza, așa cum cere proiectul înaintea oricărei actualizări.
3. Schimbați eticheta imaginii în docker-compose.yml.
4. Rulați comenzile din documentație. Fișierul Compose migrează baza la pornire.

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

Cu binarul, opriți Listmonk, înlocuiți binarul, rulați ./listmonk --upgrade, apoi relansați-l. Pentru a reveni la o versiune anterioară, restaurați exportul făcut înaintea actualizării, apoi puneți la loc vechea etichetă.

Cine ce face pe un Managed VPS

Găzduirea pe propriul server cere să țineți serverul pe lângă aplicație. Pe un Managed VPS, echipele noastre preiau serverul și vă urmăresc proactiv instanța; Listmonk rămâne software-ul dumneavoastră, cu setările, listele și campaniile dumneavoastră.

Dacă preferați ca echipele noastre să intervină în aplicația însăși, această prestație se facturează la oră sau la preț fix, cu o ofertă comunicată înainte de intervenție.