Installera Listmonk

Vad Listmonk är

Ett program för nyhetsbrev och utskick. Ni lägger upp en lista med prenumeranter, skriver ett brev, och skickar det till alla på en gång. Sedan ser ni hur många som öppnade det och vilka länkar de klickade på.

Det låter som något ni kan göra från företagets mejlkonto, och för tjugo mottagare stämmer det. Vid tvåhundra gör ni det inte längre. Mejlprogram har gränser för hur många mottagare som accepteras per dygn, avprenumerationslänken måste finnas och fungera, och den som får brevet ska inte se adresserna till alla andra. Listmonk sköter den delen.

Det finns också en juridisk sida. Skickar ni marknadsföring till privatpersoner i Sverige krävs som huvudregel att de har sagt ja i förväg, och att varje utskick innehåller ett enkelt sätt att säga nej (undantag finns för befintliga kunder som får liknande erbjudanden och inte har sagt nej). Är mottagaren i stället ett företag (B2B) gäller inte det förhandssamtycket. Listmonk lägger in avprenumerationslänken automatiskt, men samtycket måste ni samla in själva, och det ska gå att visa upp.

Det här är ett serverprogram

Listmonk behöver en databas och en maskin som kör. Docker ordnar båda. Har ni inte Docker, börja med Installera Docker.

Programmet skickar inte mejlen själv. Det behöver en så kallad SMTP-server, alltså ett konto hos en tjänst som faktiskt levererar posten. Företagets vanliga mejlkonto fungerar för små utskick, en avsändartjänst är rätt när volymen växer. Listmonk är gratis och öppen källkod, men avsändartjänsten är det ofta inte, så räkna med den kostnaden i kalkylen.

Windows och Linux Mint

Samma fil på båda. Skapa en mapp som heter listmonk i hemmappen, alltså i C:\Users\ert-namn på Windows och i /home/ert-namn på Linux Mint, och en tom undermapp i den som heter uploads. Lägg sedan en textfil som heter compose.yaml i listmonk-mappen:

services:
  app:
    image: listmonk/listmonk:latest
    depends_on:
      - db
    ports:
      - "9000:9000"
    command: [sh, -c, "./listmonk --install --idempotent --yes --config '' && ./listmonk --upgrade --yes --config '' && ./listmonk --config ''"]
    environment:
      LISTMONK_app__address: 0.0.0.0:9000
      LISTMONK_db__host: db
      LISTMONK_db__port: 5432
      LISTMONK_db__user: listmonk
      LISTMONK_db__password: BYT_UT_MIG
      LISTMONK_db__database: listmonk
      LISTMONK_db__ssl_mode: disable
      LISTMONK_ADMIN_USER: admin
      LISTMONK_ADMIN_PASSWORD: BYT_UT_MIG_ADMIN
      TZ: Europe/Stockholm
    volumes:
      - ./uploads:/listmonk/uploads:rw
    restart: unless-stopped

  db:
    image: postgres:17-alpine
    environment:
      POSTGRES_USER: listmonk
      POSTGRES_PASSWORD: BYT_UT_MIG
      POSTGRES_DB: listmonk
    volumes:
      - listmonk-data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U listmonk"]
      interval: 10s
      timeout: 5s
      retries: 6
    restart: unless-stopped

volumes:
  listmonk-data:

Den långa command-raden ser krånglig ut men gör något enkelt: den sätter upp databasen första gången, kör eventuella uppdateringar vid senare starter, och startar sedan programmet. Rör den inte.

De två raderna som heter BYT_UT_MIG är databasens lösenord och ska vara identiska. BYT_UT_MIG_ADMIN är ert eget inloggningslösenord.

Öppna terminalen och gå in i mappen. På Windows är det PowerShell:

cd $HOME\listmonk

På Linux Mint heter programmet Terminal:

cd ~/listmonk

Starta sedan:

docker compose up -d

Hittar Docker ingen compose.yaml står ni i fel mapp, och cd-raden löser det. Öppna sedan http://localhost:9000. Vi körde precis den här uppsättningen och loggade in med kontot ovan.

localhost betyder den egna datorn och ingenting annat. Vill ni visa utskicket för någon i företaget går det alltså inte att skicka länken: den personen hamnar på sin egen maskin. Att bygga listor och mallar lokalt fungerar bra. Ska flera sköta utskicken behöver Listmonk ligga på en maskin som står på och nås på den maskinens adress.

Tre saker att göra först

1. Fyll i avsändaruppgifterna under Settings innan ni skapar något utskick: avsändarnamn, avsändaradress och SMTP-inställningarna från er mejlleverantör. Ett brev utan fungerande avsändare hamnar i skräpposten hos alla.
2. Skicka ett testutskick till er själva och till någon utanför företaget, gärna med ett annat mejlprogram. Det är enda sättet att se att avprenumerationslänken fungerar och att brevet ser ut som ni tror.
3. Skapa två listor från början: en för kunder och en för intresserade. Att dela upp dem senare kräver att någon sorterar rader för hand.

Den vanligaste fällan

Att importera en adresslista ni inte har fått tillstånd att mejla. Det är frestande att lägga in alla i kontaktboken, alla i nätverket och alla som har handlat en gång. Reglerna i marknadsföringslagen och dataskyddsförordningen ser annorlunda på saken, och det är en fråga en tillsynsmyndighet kan ställa.

Gör i stället så här: samla in adresserna via Listmonks eget anmälningsformulär, med en kryssruta där personen aktivt säger ja. Då finns samtycket dokumenterat med datum, och ni kan visa det.

Den andra vanliga missen är rent teknisk. Skickar ni tvåhundra brev på en minut från ett vanligt mejlkonto stryper leverantören er, ofta utan att tala om det. Under Settings och fliken Performance finns inställningen för hur många meddelanden Listmonk får skicka. Sätt den lågt, gärna ett i sekunden, och låt utskicket ta den tid det tar.