SendKettle op je eigen server

Met deze handleiding zet je SendKettle op één kleine gehuurde server (een VPS), met HTTPS, een queue-worker, de planner, Amazon SES om te verzenden en elke nacht een back-up. Je hoeft geen systeembeheerder te zijn. Je typt de opdrachten uit deze handleiding over, en een installatiescript doet de rest.

De voorbeelden gebruiken Hetzner Cloud. DigitalOcean werkt op dezelfde manier; waar het verschilt, staat het erbij. Reken op ongeveer een uur, plus wachttijd voor DNS en voor Amazon om je SES-account goed te keuren.

De schermen van Hetzner, DigitalOcean en Amazon veranderen af en toe, en ze zijn meestal in het Engels. Een knop kan dus net anders heten dan in deze handleiding. Zoek dan naar de knop die er het meest op lijkt.

Voordat je begint

Je hebt nodig:

  1. Een domeinnaam die van jou is, bijvoorbeeld example.com, en een login bij het bedrijf waar de DNS ervan wordt beheerd (vaak waar je het domein kocht).

  2. Een subdomein voor SendKettle, bijvoorbeeld news.example.com. Deze handleiding gebruikt die naam; typ steeds je eigen naam.

  3. Jouw kopie van SendKettle op GitHub (of een andere git-host). Noteer het adres, bijvoorbeeld https://github.com/you/the_mailroom.git.

  4. Een computer met een terminal: Terminal op macOS, PowerShell op Windows 10 of 11, of een terminal op Linux.

  5. Een SSH-sleutel. Heb je die nog niet, maak hem dan nu op je computer:

    ssh-keygen -t ed25519 -C "you@example.com"
    

    Druk op Enter om de bestandsnaam te accepteren en typ een wachtwoordzin die je onthoudt. Laat daarna het openbare deel zien, dat je in Hetzner plakt:

    cat ~/.ssh/id_ed25519.pub
    

    Dat is één regel die begint met ssh-ed25519. Op Windows is de opdracht type $env:USERPROFILE\.ssh\id_ed25519.pub.

Kosten

Ruwe prijzen per maand, zonder btw, eind 2026. Kijk op de prijspagina's van de aanbieders voordat je bestelt.

Wat Ruwe kosten per maand Toelichting
Hetzner Cloud CX22 (2 vCPU, 4 GB RAM, 40 GB schijf) 4 tot 5 euro Inclusief het openbare IPv4-adres.
Hetzner-serverback-ups (optioneel) ongeveer 1 euro 20% van de serverprijs. Dagelijkse momentopnamen van de hele server, naast de back-ups uit deze handleiding.
Hetzner Storage Box BX11 (1 TB) 3 tot 4 euro Voor de nachtelijke back-ups.
Domeinnaam ongeveer 1 euro Meestal per jaar betaald (10 tot 15 euro).
Amazon SES ongeveer 1 euro per 10.000 e-mails 0,10 Amerikaanse dollar per 1.000 e-mails.
Postmark (in plaats van SES) vanaf ongeveer 15 euro Voor 10.000 e-mails per maand.
Anthropic API (optioneel) meestal minder dan 1 euro Je betaalt per gebruik van de AI-assistent.
Uptime-bewaking 0 euro De gratis abonnementen van UptimeRobot of Better Stack zijn genoeg.
DigitalOcean (in plaats van Hetzner) ongeveer 11 euro Een droplet met 2 GB kost 12 Amerikaanse dollar.

Voor een hobbyproject dat 10.000 e-mails per maand verstuurt, met Hetzner en SES, kom je meestal uit op ongeveer 10 euro.

Stap 1: De server aanmaken

Bij Hetzner Cloud

  1. Maak een account bij Hetzner en open de Cloud Console. Maak een Project, bijvoorbeeld "SendKettle", en open het.
  2. Klik op Servers en dan op Add Server (soms Create Server).
  3. Location: kies een plek dicht bij jou of je abonnees, bijvoorbeeld Falkenstein, Neurenberg of Helsinki.
  4. Image: kies Ubuntu 24.04.
  5. Type: kies Shared vCPU, x86 (Intel/AMD) en dan CX22. Staat CX22 er niet meer bij, kies dan het kleinste pakket in dezelfde rij met minstens 2 GB RAM (Hetzner geeft deze soms een nieuwe naam, bijvoorbeeld CX23).
  6. Networking: laat Public IPv4 en Public IPv6 allebei aan staan.
  7. SSH keys: klik op Add SSH key, plak de regel die begint met ssh-ed25519, geef de sleutel een naam en klik op Add SSH key. Zorg dat hij aangevinkt is.
  8. Firewalls: klik op Create Firewall. Houd bij Inbound rules de regel voor SSH (TCP, poort 22) en voeg een regel toe voor TCP poort 80 en een voor TCP poort 443, allebei vanaf Any IPv4 en Any IPv6. Noem hem "sendkettle", maak hem aan en zorg dat hij voor de nieuwe server is gekozen.
  9. Backups: optioneel. Dit kost 20% extra en bewaart 7 dagelijkse momentopnamen van de hele server.
  10. Name: bijvoorbeeld sendkettle.
  11. Klik op Create & Buy now.

Na een minuut toont de server een IPv4-adres zoals 203.0.113.10 en een IPv6-netwerk zoals 2001:db8:1234:5678::/64. Schrijf ze allebei op.

Bij DigitalOcean

  1. Klik op Create en dan op Droplets.
  2. Kies een Region en kies bij Choose an image voor Ubuntu 24.04 (LTS) x64.
  3. Bij Choose Size: Basic, Regular en het pakket met 2 GB geheugen. Het pakket met 1 GB werkt ook; het installatiescript voegt wisselgeheugen toe, zodat Composer genoeg geheugen heeft.
  4. Kies bij Choose Authentication Method voor SSH Key, klik op New SSH Key, plak je sleutel en voeg hem toe.
  5. Vink Enable IPv6 aan als dat wordt aangeboden en klik op Create Droplet.
  6. Open Networking en dan Firewalls, en klik op Create Firewall. Houd SSH en voeg bij Inbound Rules HTTP en HTTPS toe. Kies bij Apply to Droplets je droplet en maak de firewall aan.

Stap 2: Een subdomein naar de server laten wijzen

Voeg bij het bedrijf dat de DNS van je domein beheert deze records toe. De velden heten bij elk bedrijf net anders (Naam of Host, Waarde of Verwijst naar, TTL).

Type Naam Waarde
A news Het IPv4-adres, bijvoorbeeld 203.0.113.10
AAAA news Het IPv6-adres van de server, bijvoorbeeld 2001:db8:1234:5678::1

Hetzner toont een heel IPv6-netwerk dat eindigt op ::/64. De server zelf gebruikt het eerste adres daarin: vervang ::/64 door ::1. Twijfel je, laat het AAAA-record dan weg; alleen IPv4 werkt ook.

Sommige DNS-beheerders willen de volledige naam (news.example.com) in plaats van news. Kun je een TTL kiezen, neem dan 300 seconden of de laagste waarde, zodat je fouten snel kunt herstellen.

Controleer of het record werkt. Voer op je computer uit:

nslookup news.example.com

Het antwoord moet het adres van je server tonen. Het kan een paar minuten tot een paar uur duren voordat dat zo is. Je kunt intussen met stap 3 beginnen; het script zegt het als de DNS nog niet klaar is.

Stap 3: Het installatiescript uitvoeren

  1. Log vanaf je computer in op de server:

    ssh root@203.0.113.10
    

    Typ de eerste keer yes als gevraagd wordt of je de server vertrouwt.

  2. Download het installatiescript. Vervang you/the_mailroom door jouw repository en main door jouw branch:

    curl -fsSLO https://raw.githubusercontent.com/you/the_mailroom/main/deploy/install.sh
    

    Is je repository privé, dan werkt dat adres niet. Kopieer het bestand dan vanaf je eigen computer, vanuit je kopie van de code: scp deploy/install.sh root@203.0.113.10:

  3. Voer het uit met je eigen waarden:

    bash install.sh --domain news.example.com --email you@example.com --repo https://github.com/you/the_mailroom.git
    
    • --domain is het subdomein uit stap 2.
    • --email is waar Let's Encrypt een waarschuwing heen stuurt als je certificaat ooit niet verlengd kan worden.
    • --repo is je repository. Gebruik voor een privérepository het SSH-adres, zoals git@github.com:you/the_mailroom.git. Het script toont dan een sleutel; voeg die op GitHub toe bij je repository onder Settings, Deploy keys, Add deploy key (laat Allow write access uit) en druk op Enter.
    • Voeg --branch naam toe als de code die je wilt niet op de standaardbranch van de repository staat.

    Laat je een optie weg, dan vraagt het script erom.

  4. Wacht ongeveer 5 tot 10 minuten. Het script toont elke stap. Aan het eind staat SendKettle is installed. met een lijst van volgende stappen.

Stopt het script, lees dan de laatste regels: daar staat wat er misging. Los het op en voer dezelfde opdracht opnieuw uit. Twee keer uitvoeren kan geen kwaad; het script kijkt wat er al is en houdt je gegevens.

Was de DNS nog niet klaar, dan slaat het script het certificaat over en meldt dat. Wacht tot nslookup het juiste adres toont en voer de opdracht opnieuw uit. HTTPS is verplicht: zonder kun je niet inloggen.

Wat het script instelt

Onderdeel Details
Gebruiker Een gebruiker deploy die de code bezit en de website, de queue-worker en de planner draait. Je SSH-sleutel werkt ook voor deze gebruiker.
Software PHP 8.4 (uit de pakketbron ondrej/php) met de extensies die SendKettle nodig heeft, nginx, Composer, git, SQLite, supervisor, certbot, restic, ufw, fail2ban en automatische beveiligingsupdates.
Code /var/www/sendkettle, geïnstalleerd met composer install --no-dev --optimize-autoloader.
Instellingen .env met productiewaarden (zie Instellingen in het .env-bestand) en een nieuwe APP_KEY.
Database SQLite in /var/www/sendkettle/database/database.sqlite, gemigreerd. Geen demogegevens en geen demologin.
Webserver nginx voor je subdomein, met beveiligingsheaders, uploads tot 20 MB, verborgen bestanden zoals .env geblokkeerd en /.well-known/ open voor de app.
HTTPS Een certificaat van Let's Encrypt dat zichzelf verlengt (certbot.timer).
Queue-worker Het supervisor-programma sendkettle-worker, dat de e-mails verstuurt. Het luistert naar de queues op volgorde van voorrang (--queue=system,journeys,webhooks,default,campaigns,imports), zodat een grote campagne nooit journey-e-mails, webhooks of systeemtaken ophoudt. Het herstart zichzelf elk uur en na een crash.
Planner Een cron-regel in /etc/cron.d/sendkettle die elke minuut schedule:run uitvoert, plus de nachtelijke back-up.
Beveiliging Firewall alleen open op poort 22, 80 en 443, fail2ban voor SSH, geen wachtwoorden voor SSH (alleen sleutels) en dagelijkse beveiligingsupdates.

Stap 4: Je eerste beheerder aanmaken

De installatie maakt nooit de demologin admin@example.com met het wachtwoord password aan. Maak in plaats daarvan je eigen account. Vroeg het script Create your admin account now? en antwoordde je ja, dan heb je dit al gedaan.

Voer op de server uit:

sudo -u deploy php8.4 /var/www/sendkettle/artisan sendkettle:admin

De opdracht vraagt in het Engels om:

  1. Email address: het adres waarmee je inlogt.
  2. Name: je naam.
  3. Password (at least 12 characters) en daarna Type the password again. Je ziet niets terwijl je typt; dat hoort zo.

Open daarna https://news.example.com/login en log in. Je account is een Owner (eigenaar), de rol die alles mag.

Beveilig het account daarna met tweestapsverificatie: klik op je naam, open Profiel en stel het daar in. Zie Tweestapsverificatie en single sign-on.

Dezelfde opdracht helpt als je buitengesloten bent: voer hem uit met een bestaand e-mailadres, antwoord ja, en dat account wordt een Owner met het nieuwe wachtwoord.

Heb je ooit php artisan migrate --seed op deze server uitgevoerd, dan bestaat het demoaccount. Verwijder het onder Team nadat je met je eigen account bent ingelogd. De productiechecklist (stap 7) waarschuwt zolang het er nog is.

Stap 5: Amazon SES koppelen

SendKettle bezorgt e-mail niet zelf. Het geeft elke e-mail aan een verzendprovider. Amazon SES is een van de goedkoopste. Deze stap heeft een aantal delen; doe ze op volgorde.

Kies een regio

  1. Log in op de AWS-console via console.aws.amazon.com. Maak eerst een AWS-account als je dat nog niet hebt.
  2. Kies rechtsboven een regio en houd die aan voor alle stappen hieronder, bijvoorbeeld Europe (Frankfurt) eu-central-1 of Europe (Ireland) eu-west-1.
  3. Typ bovenin de zoekbalk SES en open Amazon Simple Email Service.

Je domein toevoegen aan SES

Gebruik het domein van je afzenderadres, bijvoorbeeld example.com voor news@example.com. Het hoeft niet het subdomein van de server te zijn.

  1. Open in het menu links Configuration en dan Identities, en klik op Create identity.

  2. Kies Domain en typ example.com.

  3. Laat bij Advanced DKIM settings Easy DKIM en RSA_2048_BIT staan. Laat Publish DNS records to Route53 uit, tenzij je DNS bij Amazon Route 53 staat.

  4. Klik op Create identity.

  5. Open op de pagina van de identiteit Authentication, dan het onderdeel DomainKeys Identified Mail (DKIM), en klik op Publish DNS records. Je ziet drie CNAME-records zoals deze:

    Type Naam Waarde
    CNAME abcdef123._domainkey.example.com abcdef123.dkim.amazonses.com
    CNAME ghijkl456._domainkey.example.com ghijkl456.dkim.amazonses.com
    CNAME mnopqr789._domainkey.example.com mnopqr789.dkim.amazonses.com
  6. Voeg ze alle drie toe bij je DNS-beheerder. Zet je DNS-beheerder je domein zelf achter de naam, typ dan alleen het deel vóór .example.com, zoals abcdef123._domainkey.

SES controleert de records zelf. Na een tijdje (minuten, soms uren) staat de identiteit op Verified.

SPF en DMARC toevoegen

Voeg ook deze twee TXT-records toe bij je DNS-beheerder:

Type Naam Waarde
TXT example.com (vaak geschreven als @) v=spf1 include:amazonses.com ~all
TXT _dmarc.example.com (of _dmarc) v=DMARC1; p=none; rua=mailto:dmarc@example.com
  • Een domein mag maar één SPF-record hebben. Heeft example.com al een TXT-record dat begint met v=spf1 (bijvoorbeeld voor je gewone e-mail), voeg dan geen tweede toe. Zet include:amazonses.com in het bestaande record, vóór de ~all aan het eind: v=spf1 include:_spf.google.com include:amazonses.com ~all.
  • Het DMARC-record vraagt mailboxproviders om rapporten naar dmarc@example.com te sturen. Gebruik een adres dat bestaat. p=none verzamelt alleen rapporten; later kun je het strenger maken, zie Domeinen.
  • Optioneel: klik in SES bij Custom MAIL FROM domain van de identiteit op Edit en vul bounce.example.com in. SES toont dan een MX- en een TXT-record om toe te voegen. Bounces komen dan van je eigen domein, en dat helpt bij DMARC.

De SES-sandbox verlaten

Een nieuw SES-account zit in de "sandbox": het mag alleen versturen naar adressen die je hebt geverifieerd, en hooguit 200 e-mails per dag. Vraag Amazon om dat op te heffen:

  1. Open in het SES-menu Account dashboard (of Get set up) en klik op Request production access.
  2. Mail type: Marketing.
  3. Website URL: je website, of https://news.example.com.
  4. Use case description: leg in een paar zinnen (in het Engels) uit hoe mensen op je lijst komen en hoe je met bounces omgaat. Bijvoorbeeld: "I send a monthly newsletter to people who signed up on my website with double opt-in. Every email has a one-click unsubscribe link. Bounces and complaints are processed automatically through an SNS webhook and those addresses are removed from the list."
  5. Vink aan dat je akkoord gaat met de voorwaarden en klik op Submit request.

Amazon antwoordt meestal binnen een dag. Verifieer intussen je eigen adres, zodat je kunt testen: Identities, Create identity, Email address, en klik op de link in de e-mail van Amazon.

SMTP-gegevens aanmaken

SendKettle praat met SES via SMTP. Je hebt dus SMTP-gegevens nodig; een AWS-toegangssleutel voor de SES-API werkt hier niet.

  1. Open in het SES-menu SMTP settings. Noteer het SMTP endpoint, bijvoorbeeld email-smtp.eu-central-1.amazonaws.com.
  2. Klik op Create SMTP credentials. Houd de voorgestelde gebruikersnaam en klik op Create user.
  3. Klik op Show user SMTP security credentials (of Download .csv file) en kopieer de SMTP user name en het SMTP password. Het wachtwoord zie je maar één keer.

De gegevens invullen in SendKettle

  1. Klik in SendKettle op Instellingen en dan op E-mail versturen. Je staat op de pagina Verzenden en bedrijf.
  2. Zet in het vak Verzendprovider de Provider op Amazon SES (set your region in the host).
  3. SMTP-host: het SMTP-endpoint van SES, bijvoorbeeld email-smtp.eu-central-1.amazonaws.com. De voorinstelling gebruikt eu-west-1; pas het aan als jouw regio anders is.
  4. Poort: 587. Versleuteling: STARTTLS (port 587). Op DigitalOcean, dat poort 587 bij nieuwe accounts blokkeert, gebruik je poort 2587 met dezelfde versleuteling.
  5. Gebruikersnaam: de SMTP user name. Wachtwoord / API-sleutel: het SMTP password.
  6. Standaard afzenderadres: een adres op je geverifieerde domein, zoals news@example.com. Standaard afzendernaam: je eigen naam of die van je bedrijf.
  7. Max. e-mails per minuut: SES toont je verzendsnelheid per seconde op het Account dashboard. Vermenigvuldig die met 60 en neem iets minder, bijvoorbeeld 600 bij 14 per seconde. Gebruik 60 zolang je nog in de sandbox zit.
  8. Vul Bedrijfs- of afzendernaam, Postadres en Tijdzone in. De wet verplicht je naam en postadres in marketingmail.
  9. Klik op Instellingen opslaan.
  10. Typ in het vak Een testmail versturen een adres (in de sandbox: een adres dat je in SES hebt geverifieerd) en klik op Testmail versturen. Mislukt het, dan toont de melding de fout van SES.

Meer over deze velden: Verzenden en bezorgbaarheid.

Het domein controleren in SendKettle

SendKettle controleert je SPF-, DKIM- en DMARC-records ook, en de productiechecklist heeft dit nodig.

  1. Scrol in Instellingen naar Verifieer je domein en klik op Domeinen openen.
  2. Typ in het vak Verzenddomeinen example.com bij Domein en klik op Domein toevoegen.
  3. Vul op de pagina van het domein in het vak Recordinstellingen in:
    • DKIM-selector: het eerste deel van een van de drie SES-namen, vóór ._domainkey, bijvoorbeeld abcdef123.
    • SPF-include: amazonses.com.
    • DKIM-waarde: de waarde van datzelfde record, bijvoorbeeld abcdef123.dkim.amazonses.com.
  4. Klik op Recordinstellingen opslaan en daarna op DNS-records controleren.

Staan SPF, DKIM en DMARC alle drie op Goedgekeurd, dan staat het domein op Geverifieerd. Mislukt er een, dan zegt de pagina wat er gevonden is en hoe je het oplost. DNS-wijzigingen hebben soms tijd nodig; controleer later opnieuw. De handleiding Domeinen heeft meer details.

Bounces en klachten terugsturen

Als een adres bounced of iemand je e-mail als spam markeert, kan SES dat aan SendKettle laten weten, zodat dat adres geen e-mail meer krijgt. Zo blijft je SES-account in goede staat.

  1. Open in SendKettle Instellingen en zoek het vak Webhooks voor bounces en klachten. Klik op het adres naast Ses en kopieer het. Het ziet eruit als https://news.example.com/webhooks/ses/ gevolgd door een lange geheime code. Behandel het als een wachtwoord.
  2. Zoek in de AWS-console, in dezelfde regio, naar SNS en open Simple Notification Service.
  3. Open Topics en klik op Create topic. Kies Standard, noem het sendkettle-feedback en klik op Create topic.
  4. Klik op de pagina van het topic op Create subscription. Protocol: HTTPS. Endpoint: plak het adres uit stap 1. Laat Enable raw message delivery uit. Klik op Create subscription. De status is Pending confirmation.
  5. Kopieer de ARN van het topic bovenaan de pagina van het topic (hij begint met arn:aws:sns:). Open in SendKettle Instellingen, plak hem bij Amazon SES, SNS topic ARNs en klik op Opslaan. Doe dit voordat AWS de bevestiging stuurt, want SendKettle accepteert alleen berichten van topics in deze lijst. AWS stuurt daarna een ondertekend bevestigingsverzoek. SendKettle controleert de handtekening en bevestigt het abonnement zelf. Ververs het abonnement in AWS: de status wordt Confirmed. Blijft het op Pending confirmation staan, controleer dan de ARN in Instellingen en klik in AWS bij het abonnement op Request confirmation.
  6. Open in SES Identities, klik op example.com en open het tabblad Notifications. Klik bij Feedback notifications op Edit.
  7. Zet Bounce feedback en Complaint feedback op het topic sendkettle-feedback. Klik op Save changes.

Test het door vanuit Instellingen een testmail te sturen naar bounce@simulator.amazonses.com (of complaint@simulator.amazonses.com). Een minuut later toont de pagina Systeemstatus onder Help bij Bounce-webhooks "Laatste van Ses".

Postmark in plaats van SES

Postmark is duurder, maar eenvoudiger in te stellen en staat bekend om goede bezorging.

  1. Maak in Postmark een Server en gebruik de Default Broadcast Stream voor nieuwsbrieven. Postmark houdt marketingmail gescheiden van transactionele mail en verwacht nieuwsbrieven op een broadcast stream.
  2. Voeg bij Sender Signatures je domein toe, en voeg de DKIM- en Return-Path-records die Postmark toont toe bij je DNS-beheerder.
  3. Maak in de instructies van de broadcast stream SMTP-gegevens voor die stream aan (de namen kunnen afwijken).
  4. Kies in SendKettle Provider: Postmark en vul de gebruikersnaam en het wachtwoord uit stap 3 in.
  5. Voeg in de Postmark-stream een webhook toe naar het Postmark-adres uit Webhooks voor bounces en klachten, met Bounce en Spam complaint aan.
  6. Voeg onder Domeinen je domein toe met de DKIM-selector die Postmark toont en de SPF-include spf.mtasv.net.

Versturen via het platform (cloudeditie)

Dit is alleen voor de gehoste (cloud)editie. In het superbeheerpaneel kun je een account laten versturen via het eigen Amazon SES-account van het platform in plaats van via zijn eigen sleutels (zie Superbeheerpaneel). De sleutels van het platform staan alleen in het .env-bestand. Ze worden nooit in de database opgeslagen, dus geen instellingenpagina, export of API-antwoord kan ze bevatten.

Stel het één keer in bij AWS, in de regio waarvandaan je verstuurt:

  1. Haal het SES-account in die regio uit de sandbox en verifieer het eigen domein van het platform, zoals in de stappen hierboven.
  2. Maak in SNS een topic van het type Standard aan, bijvoorbeeld sendkettle-platform-events. Kopieer de ARN.
  3. Klik bij het topic op Create subscription. Protocol: HTTPS. Endpoint: https://news.example.com/webhooks/platform-ses (je APP_URL). SendKettle bevestigt het abonnement zelf zodra PLATFORM_SES_TOPIC_ARN is ingevuld.
  4. Pas de Access policy van het topic aan, zodat alleen SES in je eigen AWS-account erop mag publiceren: sta sns:Publish toe voor de service ses.amazonaws.com met de voorwaarde aws:SourceAccount gelijk aan je account-id.
  5. Maak in IAM een gebruiker (of rol) voor SendKettle met alleen deze SES-rechten: ses:SendEmail, ses:SendRawEmail, ses:CreateConfigurationSet, ses:CreateConfigurationSetEventDestination, ses:CreateEmailIdentity, ses:DeleteEmailIdentity, ses:GetAccount. Maak er een toegangssleutel voor aan.
  6. Optioneel, maar aan te raden: maak in CloudWatch twee alarmen op de SES-metrics Reputation.BounceRate (bijvoorbeeld boven 0.04) en Reputation.ComplaintRate (bijvoorbeeld boven 0.0008), met het topic uit stap 2 als actie wanneer het alarm afgaat. Sta in de access policy van het topic ook sns:Publish toe voor cloudwatch.amazonaws.com. SendKettle hoort dan binnen een paar minuten van een reputatieprobleem; zonder alarmen merkt het dat bij de controle van de SES-accountstatus, elk uur.

Zet daarna deze waarden in .env en bouw de opgeslagen instellingen opnieuw op:

Instelling Waarde
PLATFORM_SES_KEY De access key ID uit stap 5.
PLATFORM_SES_SECRET De secret access key uit stap 5.
PLATFORM_SES_REGION De SES-regio, bijvoorbeeld eu-west-1.
PLATFORM_SES_TOPIC_ARN De ARN uit stap 2.
PLATFORM_SES_PREFIX Optioneel, standaard sendkettle. Komt voor de naam van elke configuratieset, zoals sendkettle-account-12. Gebruik per installatie een andere als meerdere installaties één SES-account delen.

Wat er dan gebeurt:

  • Zet je een account op versturen via het platform, dan maakt SendKettle de configuratieset voor dat account aan en stuurt die de bounces, klachten, afleveringen en vertragingen naar het topic.
  • Elk verzenddomein van het account wordt aan SES toegevoegd met een DKIM-sleutel die SendKettle heeft gemaakt. De klant voegt één DKIM-TXT-record toe (selector sk1), plus SPF met include:amazonses.com en DMARC, zoals op de pagina van het domein staat.
  • Elke e-mail noemt de configuratieset van het account en draagt de werkruimte mee als berichttag. Een melding wordt alleen verwerkt als de werkruimte in de tag bij het account van de configuratieset hoort. Berichten die niet door SNS zijn ondertekend, van een ander topic komen, ouder zijn dan een uur of al eerder binnenkwamen, worden geweigerd.
  • Een reputatiealarm op het topic, of een SES-accountstatus die niet gezond is bij de controle van elk uur, pauzeert de accounts die via het platform versturen met de hoogste bounce- of klachtpercentages en mailt de superbeheerders. Zie Automatisch pauzeren.

Ingebouwd versturen (cloudeditie)

Met Ingebouwd gaat de e-mail van klanten via de eigen MAIL_-instellingen van deze server, bijvoorbeeld Postfix op de server zelf (MAIL_URL=smtp://127.0.0.1:25?auto_tls=false). Klanten versturen altijd vanaf hun eigen geverifieerde domein, dus SendKettle ondertekent die e-mail zelf met een DKIM-sleutel die het per verzenddomein maakt (de DKIM-ondertekenaar van Symfony, relaxed/relaxed, rsa-sha256). De klant publiceert de openbare sleutel op sk1._domainkey.<hun domein>; de privésleutel wordt versleuteld opgeslagen met APP_KEY. Alleen e-mail vanaf een domein dat in de verzendende werkruimte geverifieerd is, wordt ondertekend, en alleen met de sleutel van die werkruimte.

Als beheerder van het platform:

  1. Laat OpenDKIM het eigen domein van het platform (bijvoorbeeld sendkettle.com) blijven ondertekenen zoals nu. SendKettle ondertekent de domeinen van het platform nooit, dus wachtwoordherstel, uitnodigingen en andere platformmail blijven op OpenDKIM leunen. Zorg dat OpenDKIM alleen zijn eigen domeinen ondertekent (zijn SigningTable, bijvoorbeeld *@sendkettle.com sendkettle), zodat klantmail niet twee keer ondertekend wordt. Gebeurt dat toch, dan kan het geen kwaad: de handtekening van SendKettle dekt geen Received- of DKIM-Signature-headers, dus de handtekening die OpenDKIM erbovenop zet laat hem geldig, en DMARC slaagt op de aansluitende handtekening van de klant. Het voegt alleen bytes en een niet-aansluitende d= van het platform aan elke klantmail toe.

  2. Publiceer de SPF-host die klanten opnemen, met het openbare adres van de server:

    _spf.sendkettle.com.  TXT  "v=spf1 ip4:<IPv4 van de server> -all"
    

    Voeg ook ip6:<IPv6 van de server> toe als de server via IPv6 verstuurt.

  3. Zet SENDKETTLE_SPF_INCLUDE=_spf.sendkettle.com in .env en bouw de gecachete instellingen opnieuw op. De domeinpagina vraagt klanten dan om include:_spf.sendkettle.com en de controle eist die. Zonder deze instelling valt de SPF-controle terug op de SPF-include die bij het domein is opgeslagen, als die er is.

  4. Controleer dat het adres van de server een passende reverse-DNS-naam (PTR) heeft, zoals bij elke mailserver.

De envelope-afzender (Return-Path) van ingebouwde e-mail van klanten is een ondertekend bounce-adres op het via-domein, één per ontvanger, zoals bounce+12-<handtekening>@send.sendkettle.com (zie het volgende deel). SPF wordt dan voor het via-domein gecontroleerd en klopt daar, dus de SPF-include op het eigen domein van klanten is optioneel; DKIM alleen geeft DMARC-alignment. Met SENDKETTLE_PLATFORM_RETURN_PATH=false blijft het eigen afzenderadres van de klant de envelope-afzender, zoals voorheen.

Ingebouwde DKIM staat aan in de cloudeditie en uit op zelf beheerde servers. SENDKETTLE_BUILTIN_DKIM=true of false gaat daarboven. Ruwe MIME die via de transactionele SMTP-relay binnenkomt, wordt ongewijzigd doorgegeven, zonder handtekening.

Versturen via het platformadres (cloudeditie)

Een werkruimte waarvan het afzenderdomein niet gekoppeld is, verstuurt toch meteen: vanaf een vast eigen adres op het via-domein, zoals duranet@send.sendkettle.com, met de naam "Duranet via SendKettle" en Reply-To op het eigen adres van de klant. SendKettle ondertekent die e-mail in de app met de eigen DKIM-sleutel van het platform voor het via-domein, dus OpenDKIM hoeft niet te veranderen. Klanten kunnen het adres niet kiezen; het wordt één keer per werkruimte gemaakt uit de bedrijfsnaam. Zie Domeinen.

Instelling Standaard Wat het doet
SENDKETTLE_VIA true Met false staat versturen via het platformadres uit: klanten moeten dan eerst hun eigen domein koppelen (de strenge regel van voorheen).
SENDKETTLE_VIA_DOMAIN send. + de host van APP_URL Het via-domein. Houd het een subdomein dat alleen hiervoor dient.
SENDKETTLE_VIA_DKIM_SELECTOR sk1 De DKIM-selector van de sleutel van het platform.
SENDKETTLE_PLATFORM_RETURN_PATH true Zet de envelope-afzender van alle ingebouwde e-mail van klanten op het via-domein, zodat bounces terugkomen in de app.

Als eigenaar van het platform, één keer:

  1. Toon de records. De eerste keer maakt het commando de 2048-bit DKIM-sleutel van het platform en bewaart die versleuteld (met APP_KEY) als platforminstelling:

    sudo -u www-data php artisan sendkettle:via-domain --ip=<IPv4 van de server>
    
  2. Publiceer deze records voor het via-domein (hier send.sendkettle.com):

    send.sendkettle.com.                  TXT  "v=spf1 ip4:<IPv4 van de server> -all"
    sk1._domainkey.send.sendkettle.com.   TXT  "v=DKIM1; k=rsa; p=<de sleutel die het commando toont>"
    _dmarc.send.sendkettle.com.           TXT  "v=DMARC1; p=quarantine; adkim=r; aspf=r"
    send.sendkettle.com.                  MX   10 <de mailhostnaam van deze server>
    

    Zet er ip6:<IPv6 van de server> bij in het SPF-record als de server over IPv6 verstuurt. Je kunt rua=mailto:... toevoegen aan het DMARC-record, met een mailbox die je leest.

  3. Laat Postfix alle e-mail voor het via-domein aannemen en aan SendKettle geven. Eén pipe doet alles: bounces en klachten komen bij de juiste werkruimte terecht, en antwoorden die naar het via-adres van een werkruimte zelf gaan, worden doorgestuurd naar het antwoordadres van die werkruimte. Het script regelt dit allemaal, alleen waar het nog niet geregeld is, en maakt eerst een reservekopie van elk bestand dat het wijzigt (<bestand>.bak-<datum-tijd>):

    sudo VIA_DOMAIN=send.sendkettle.com APP_DIR=/var/www/sendkettle APP_USER=www-data PHP_BIN=/usr/bin/php \
      bash /var/www/sendkettle/scripts/postfix-via-domain.sh
    

    Vul bij APP_DIR, APP_USER (de gebruiker die eigenaar is van de app en in storage mag schrijven) en PHP_BIN de waarden van je server in. Met de hand komt het hierop neer:

    # /etc/postfix/main.cf (laat staan wat al in relay_domains en transport_maps staat)
    relay_domains = $mydestination, send.sendkettle.com
    transport_maps = hash:/etc/postfix/transport
    recipient_delimiter = +
    
    # /etc/postfix/transport
    send.sendkettle.com   sendkettle-via:
    
    # /etc/postfix/master.cf
    sendkettle-via unix - n n - 10 pipe
      flags=Rq user=www-data argv=/usr/bin/php /var/www/sendkettle/artisan sendkettle:via-mail --sender=${sender} -- ${original_recipient}
    

    Voer daarna sudo postmap /etc/postfix/transport, sudo postfix check en sudo systemctl reload postfix uit. Servers die eerder met de sendkettle-bounce-pipe zijn ingericht, blijven werken: sendkettle:bounce is de oude naam van hetzelfde commando, en dat leest de afzender uit de Return-Path-header die Postfix toevoegt. Met sendkettle-via (draai het script) wordt de afzender expliciet meegegeven.

    Wat de pipe met elk bericht doet:

    • bounce+<werkruimte>-<handtekening>@: een bounce of klacht. De handtekening dekt de werkruimte en de ene ontvanger naar wie die e-mail ging, dus een melding telt alleen voor die ontvanger. Bounce-adressen in de oudere vorm (alleen voor de werkruimte ondertekend) worden genegeerd.
    • <adres van de werkruimte>@ (zoals duranet@, ook met +iets): een antwoord op het via-adres zelf. Het wordt vanaf no-reply@send.sendkettle.com doorgestuurd naar het Antwoordadres onder Instellingen, Standaard afzender (anders het standaard afzenderadres), met de oorspronkelijke afzender als Reply-To, ondertekend met de via-DKIM-sleutel van het platform. Het verschijnt ook in de gedeelde inbox van de werkruimte. Het gaat nooit naar een ander adres.
    • Al het andere, zoals een onbekende naam of no-reply@: weggegooid zonder antwoord, zodat een vervalste afzender nooit een bounce krijgt (geen backscatter).

    Antwoorden worden niet doorgestuurd voor een gepauzeerd of gesloten account, boven SENDKETTLE_VIA_REPLIES_PER_HOUR (standaard 100) per werkruimte per uur, boven SENDKETTLE_VIA_REPLY_MAX_BYTES (standaard 10 MB), twee keer voor dezelfde Message-ID, als ze van het via-domein komen of al eerder zijn doorgestuurd, als het een automatisch antwoord van het eigen antwoordadres van de werkruimte is, vaker dan één automatisch antwoord per uur van dezelfde afzender, of als het bulk- of lijstmail van dit platform is. Elk bericht wordt gelogd met de werkruimte en wat ermee gebeurde (Via reply forwarded, Via reply dropped (rate limit) enzovoort), zonder adressen.

  4. Houd het via-domein uit de SigningTable van OpenDKIM: de app ondertekent die e-mail, doorgestuurde antwoorden inbegrepen. Het script zet regels voor het via-domein uit (met een reservekopie) en waarschuwt voor een wildcard zoals *@*.sendkettle.com die er ook op zou passen. sendkettle.com zelf blijft in de SigningTable.

  5. Accounts met platformverzending (Amazon SES): voeg het via-domein toe als geverifieerde identiteit in dezelfde SES-regio, met Easy DKIM. Hun via-e-mail gaat dan via de configuratieset van het account, en bounces komen zoals voorheen via SNS terug.

  6. Open de productiechecklist: DKIM-record van het via-domein slaagt zodra het DKIM-record gepubliceerd is.

Ruwe MIME (de send-raw-API en de transactionele SMTP-relay) kan niet worden aangepast, dus daarvoor is nog steeds een afzenderadres op een gekoppeld domein nodig; anders wordt het geweigerd.

Optioneel: SENDKETTLE_DOMAIN_CONNECT=true toont Automatisch koppelen op de pagina van een domein als de DNS-beheerder van de klant Domain Connect ondersteunt en het sjabloon van SendKettle kent. Dit blijft uit tot dat sjabloon is geaccepteerd; zie Domain Connect.

Stap 6: De AI-assistent aanzetten (optioneel)

De AI-assistent schrijft onderwerpregels, herschrijft tekst en maakt conceptmails met Claude. Hij staat uit tot je een API-sleutel van Anthropic toevoegt. Anthropic rekent het gebruik rechtstreeks met jou af.

  1. Log in op console.anthropic.com, voeg een betaalmethode of tegoed toe, open API keys en klik op Create Key. Kopieer de sleutel; hij begint met sk-ant-.
  2. Open in SendKettle Instellingen en klik op het onderdeel AI.
  3. Plak de sleutel bij API-sleutel, kies een Model en klik op AI-instellingen opslaan.

Zie AI-assistent voor wat hij kan.

In de cloudversie zet je in plaats daarvan ANTHROPIC_API_KEY in .env; betaalde klanten gebruiken de assistent dan zonder eigen sleutel. Zie Diensten van het platform.

Stap 7: De productiechecklist openen

Open in SendKettle Instellingen, klik op het onderdeel Account en dan op Productiechecklist (alleen voor Admins en Owners). Je vindt hem ook onderaan Help, Systeemstatus.

De checklist controleert:

Controle Goedgekeurd als
Editie SENDKETTLE_EDITION is selfhosted of cloud
Debugmodus staat uit APP_DEBUG=false
Draait in productiemodus APP_ENV=production
Openbaar adres gebruikt HTTPS APP_URL begint met https:// en is gelijk aan het adres in je browser
Verzendprovider Er is een provider opgeslagen onder Instellingen en het is niet Log only
Verzenddomein geverifieerd Minstens één domein onder Domeinen staat op Geverifieerd
Planner Draaide in de afgelopen 5 minuten
Queue-worker Geen taak wacht langer dan 10 minuten
Geen demowachtwoord Geen Owner of Admin heeft het wachtwoord password, en admin@example.com bestaat niet
Back-ups backup.sh is in de afgelopen 26 uur klaar geweest
Opslag is beschrijfbaar De app kan schrijven in storage, bootstrap/cache en de database
Inlogcookie blijft op het adres van de app SESSION_DOMAIN is leeg, en via HTTPS heeft het inlogcookie het voorvoegsel __Host-

Bij elk onderdeel dat werk nodig heeft, staat een link Zo los je het op naar het juiste deel van deze handleiding. Direct na de installatie faalt Back-ups tot je ze instelt, en falen Verzendprovider en Verzenddomein geverifieerd tot stap 5 klaar is.

Instellingen in het .env-bestand

Het script zet deze waarden in /var/www/sendkettle/.env:

Instelling Waarde Waarom
APP_ENV production Zet ontwikkelhulpmiddelen uit en vraagt om bevestiging bij riskante opdrachten.
APP_DEBUG false Met true tonen foutpagina's code en geheimen aan iedereen.
APP_URL https://news.example.com Elke link in je e-mails wordt hiermee gemaakt.
SENDKETTLE_EDITION selfhosted De editie. Laat dit op je eigen server op selfhosted staan. cloud is voor de gehoste dienst en zet de extra onderdelen daarvan aan, zoals zelf een account aanmaken en de openbare startpagina: bezoekers die niet zijn ingelogd zien op / de openbare site (functies, prijzen, vragen, zakelijk contact en de wachtlijst, zie Publieke site), en onder /docs een paar handleidingen. Bij een andere waarde draait de app als selfhosted en meldt de productiechecklist een probleem.
SENDKETTLE_PLATFORM_DOMAINS sendkettle.io,mail.sendkettle.io Alleen voor de cloud. De eigen domeinen van het platform, met komma's ertussen. Klanten kunnen er niet vanaf versturen en ze (of hun subdomeinen) niet gebruiken voor trackinglinks en pagina's. Leeg betekent de host van APP_URL en het domein van MAIL_FROM_ADDRESS. Zie Domeinen.
LOG_LEVEL warning Logt problemen, niet elk detail.
LOG_STACK daily Elke dag een nieuw logbestand, 14 dagen bewaard (LOG_DAILY_DAYS).
SESSION_SECURE_COOKIE true Het inlogcookie gaat alleen over HTTPS.
SESSION_DOMAIN leeg Het inlogcookie hoort alleen bij het eigen adres van de app. Zet hier nooit het bovenliggende domein in (.example.com): het cookie gaat dan ook naar elke klantwebsite op een subdomein. De productiechecklist keurt het af als het is ingevuld.
SESSION_COOKIE niet ingesteld Via HTTPS heet het inlogcookie __Host-sendkettle_session en het cookie voor formuliertokens __Host-XSRF-TOKEN. Browsers accepteren een __Host--cookie alleen van het eigen adres van de app, dus een script op een klantwebsite kan er geen neerzetten. Laat het weg uit .env; na een update moet iedereen één keer opnieuw inloggen.
QUEUE_CONNECTION database E-mails wachten in de database tot de queue-worker ze verstuurt.
QUEUE_LANES true Zet campagne-e-mails, journeys, webhooks, imports en systeemtaken elk in een eigen queue. Zonder deze instelling gebruikt elke taak de ene standaardqueue, zoals op installaties van vóór deze instelling.
DB_CONNECTION, DB_DATABASE sqlite, het volledige pad Het databasebestand.
APP_KEY één keer gemaakt Versleutelt opgeslagen wachtwoorden en ondertekent links. Verander hem nooit en bewaar een kopie (de back-ups bevatten hem).

Optioneel: MAIL_FAIR_SHARE_PER_MINUTE (standaard 1000) is het hoogste aantal campagne-e-mails per minuut dat één werkruimte verstuurt zodra er meer dan één werkruimte is, ook als haar eigen Max. e-mails per minuut 0 of hoger is. De e-mails van elke werkruimte komen dan op hun beurt aan bod, in plaats van te wachten achter de 100.000 van een ander. Zet het ongeveer op wat je worker in een minuut verstuurt; 0 zet het uit. Met één werkruimte doet het niets.

Optioneel, cloud: SENDKETTLE_SPF_INCLUDE (bijvoorbeeld _spf.sendkettle.com) is de SPF-host die klanten opnemen voor ingebouwd versturen, en SENDKETTLE_BUILTIN_DKIM zet het ondertekenen van ingebouwde e-mail met de DKIM-sleutel van elke klant aan of uit (standaard aan in de cloudeditie). Zie Ingebouwd versturen.

Optioneel: met MAIL_ALLOW_PRIVATE_SMTP_HOSTS=true mogen werkruimtes versturen via een mailserver op een privénetwerk of een poort die niet voor mail is, zoals een relay op deze server. Laat het uit als mensen die je niet helemaal vertrouwt Admin van een werkruimte zijn: zij kunnen de SMTP-host dan op interne diensten richten.

Optioneel, cloud: de sleutels van de diensten die het platform aan betaalde klanten levert: ANTHROPIC_API_KEY (schrijven met AI), PLATFORM_AI_MODEL, OPENAI_API_KEY (afbeeldingen gemaakt door AI), DEEPL_API_KEY en DEEPL_API_FREE (formulieren vertalen), GIPHY_API_KEY (GIF's zoeken), EMAILONACID_API_KEY en EMAILONACID_ACCOUNT_PASSWORD (inboxvoorbeelden), RECAPTCHA_SITE_KEY, RECAPTCHA_SECRET_KEY, HCAPTCHA_SITE_KEY en HCAPTCHA_SECRET_KEY (botcontrole op formulieren) en PLATFORM_CAPTCHA (de botcontrole op de eigen formulieren van het platform). GEOIP_DATABASE_PATH is het GeoLite2-bestand voor opens per land, SAFE_BROWSING_API_KEY de sleutel van Google Safe Browsing voor de campagnecontrole; de webpush-sleutels maakt de app zelf. Een zelf gehoste server negeert de sleutels van de diensten. Zie Diensten van het platform.

Wil je een instelling wijzigen, bewerk dan het bestand en bouw de opgeslagen instellingen opnieuw:

sudo -u deploy nano /var/www/sendkettle/.env
sudo -u deploy php8.4 /var/www/sendkettle/artisan config:cache
supervisorctl restart sendkettle-worker:*

Voer je het installatiescript opnieuw uit, dan zet het de waarden uit de tabel terug, behalve APP_KEY.

Zoekmachines

Het installatiescript stelt nginx in voor snelle pagina's: stylesheets en scripts met een versie blijven een jaar in de cache, tekst wordt gecomprimeerd en /robots.txt komt van de app. Op een server die eerder is geïnstalleerd voeg je die instellingen met de hand toe. Zoekmachines noemt ze, met het doorsturen van www en de stappen voor Google Search Console.

Websites op subdomeinen (cloudeditie)

Websites van klanten staan op een eigen subdomein van een apart websitedomein, zoals bakkerij.sites.sendkettle.com. Ze draaien nooit op het eigen adres van de app: hun pagina's bevatten eigen HTML en scripts van de klant. Hieronder is sites.sendkettle.com het websitedomein en sendkettle.com de app; gebruik je eigen namen.

DNS-records

Voeg bij de DNS-beheerder van het domein (bijvoorbeeld Hetzner DNS) toe:

Type Naam Waarde
A *.sites.sendkettle.com het IPv4-adres van de server
A sites.sendkettle.com het IPv4-adres van de server
AAAA *.sites.sendkettle.com het IPv6-adres van de server, alleen als de app via IPv6 bereikbaar is
AAAA sites.sendkettle.com hetzelfde IPv6-adres, alleen als je het record hierboven toevoegde

Het wildcardrecord dekt sites.sendkettle.com zelf niet, vandaar het tweede record. Die kale naam stuurt door naar de openbare homepage.

Wildcardcertificaat

Een certificaat voor *.sites.sendkettle.com vraagt de DNS-controle van Let's Encrypt: Let's Encrypt kijkt dan naar een TXT-record in plaats van naar een webverzoek. Met Ploi en Hetzner DNS:

  1. Maak in de Hetzner DNS-console een API-token aan (API tokens) en kopieer het.
  2. Voeg dat token in Ploi toe als Hetzner DNS-provider voor de DNS-controle van certificaten.
  3. Vraag in Ploi een Let's Encrypt-certificaat aan voor sites.sendkettle.com en *.sites.sendkettle.com met DNS-controle. Ploi zet de TXT-records via het token, haalt het certificaat op en vernieuwt het zelf.

Gebruik de Ploi-site die het websitedomein gaat bedienen (volgende stap). Houd het token geheim: het kan elk record van de DNS-zone wijzigen.

nginx

Verzoeken voor het websitedomein gaan naar dezelfde app, uit dezelfde map, als sendkettle.com. Voeg de namen toe aan de site van de app in Ploi, of maak een site voor sites.sendkettle.com met dezelfde projectmap en dit serverblok. Neem root, de PHP-socket en de fastcgi-regels over uit het serverblok van de app zelf, zodat ze gelijk zijn:

server {
    listen 80;
    listen [::]:80;
    server_name sites.sendkettle.com *.sites.sendkettle.com;
    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl;
    listen [::]:443 ssl;
    http2 on;
    server_name sites.sendkettle.com *.sites.sendkettle.com;

    ssl_certificate     /etc/nginx/ssl/sites.sendkettle.com/server.crt;
    ssl_certificate_key /etc/nginx/ssl/sites.sendkettle.com/server.key;

    root /home/ploi/sendkettle.com/public;
    index index.php;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        include fastcgi_params;
        fastcgi_pass unix:/var/run/php/php8.4-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
    }
}

Gebruik de paden van het certificaat die Ploi laat zien. Voer nginx -t uit en herlaad nginx. Zet het websitedomein niet in TRUSTED_HOSTS: de app accepteert de namen vanzelf zodra SITES_DOMAIN is ingesteld.

Instellingen

In .env:

SITES_DOMAIN=sites.sendkettle.com
# Optioneel: gratis accounts krijgen een naam zoals site-4821 (standaard), of kiezen er zelf een.
SENDKETTLE_FREE_SITE_NAMES=generated
# Optioneel: meer merknamen die niet als websiteadres mogen, gescheiden door komma's.
SITES_BLOCKED_NAMES=

Laat SESSION_DOMAIN leeg en SESSION_COOKIE weg (zie Instellingen in het .env-bestand). Voer daarna php artisan migrate --force en php artisan config:cache uit en herstart de queue-worker.

Controleren

  1. curl -I https://sites.sendkettle.com/ antwoordt 301 naar de openbare homepage.
  2. curl -I https://bestaat-niet.sites.sendkettle.com/ antwoordt 404 met X-Robots-Tag: noindex, nofollow.
  3. curl -I https://bestaat-niet.sites.sendkettle.com/login antwoordt ook 404: de app zelf antwoordt nooit op het websitedomein.
  4. Publiceer een testwebsite en open hem op zijn adres onder het websitedomein.
  5. De productiechecklist laat Inlogcookie blijft op het adres van de app als goedgekeurd zien.

Updates

Om een nieuwe versie uit je repository te installeren, log je in op de server en voer je uit:

bash /var/www/sendkettle/deploy/update.sh

Het script kopieert de database, toont een pagina "zo terug", haalt de nieuwe code op met git pull, voert composer install uit, migreert de database, bouwt de caches opnieuw, herstart de queue-worker en PHP en zet de site weer open. Is er niets nieuws, dan meldt het Already up to date en stopt het.

Mislukt een update, dan blijft de site op de pagina "zo terug" en toont het script de opdrachten om terug te gaan naar je vorige versie. De kopie van de database staat in /var/www/sendkettle/database/backups/ (de nieuwste vijf blijven bewaard).

Wil je alleen getagde releases in plaats van elke wijziging op de branch, gebruik dan update.sh --to latest of --to v1.2.0. Versies en bijwerken legt de versienummers uit, de notities per release, versies overslaan en teruggaan.

Queue lanes op een oudere installatie

Servers die vóór de queue lanes zijn geïnstalleerd blijven werken: hun worker luistert naar de standaardqueue en elke taak gaat daar nog steeds heen. Wil je de lanes, voer dan het installatiescript opnieuw uit (het schrijft QUEUE_LANES=true en de nieuwe workeropdracht), of doe het met de hand:

  1. Zet QUEUE_LANES=true in /var/www/sendkettle/.env.
  2. Verander in /etc/supervisor/conf.d/sendkettle-worker.conf de opdracht in queue:work database --queue=system,journeys,webhooks,default,campaigns,imports --sleep=3 --max-time=3600.
  3. Voer sudo -u deploy php8.4 /var/www/sendkettle/artisan config:cache uit en daarna supervisorctl reread && supervisorctl update.

Verander de worker en de instelling samen: met lanes aan en de oude worker wordt niets uit de benoemde queues opgepakt.

De server installeert elke nacht zelf beveiligingsupdates voor Ubuntu en PHP. Herstart hem af en toe voor kernelupdates: reboot (de app start daarna vanzelf weer).

Back-ups

Alles wat ertoe doet staat op drie plekken: de SQLite-database, het bestand .env (vanwege APP_KEY) en geüploade bestanden in storage/. deploy/backup.sh kopieert ze elke nacht om 03:17 met restic, versleuteld, naar een plek buiten de server. De database wordt gekopieerd met de eigen .backup-opdracht van SQLite, zodat de kopie klopt, ook terwijl er e-mails worden verstuurd.

Tot je dit deel hebt afgerond, toont de productiechecklist Back-ups als mislukt.

Een Storage Box instellen

Een Storage Box van Hetzner is goedkope opslag die restic via SFTP kan bereiken.

  1. Open in de Hetzner-console Storage Boxes en bestel een BX11, als het kan op een andere locatie dan je server.

  2. Open de Storage Box. Zet bij Settings SSH support aan (en External reachability als je server niet bij Hetzner staat). Noteer de Username (zoals u123456) en de Server (zoals u123456.your-storagebox.de). Stel een wachtwoord in als daarom gevraagd wordt.

  3. Maak op je server een SSH-sleutel voor root als die er nog niet is, en kopieer hem naar de Storage Box. Vervang u123456 door jouw gebruikersnaam; er wordt één keer om het wachtwoord van de Storage Box gevraagd:

    [ -f /root/.ssh/id_ed25519 ] || ssh-keygen -t ed25519 -N "" -f /root/.ssh/id_ed25519
    cat /root/.ssh/id_ed25519.pub | ssh -p 23 u123456@u123456.your-storagebox.de install-ssh-key
    
  4. Geef de Storage Box een korte naam voor SSH:

    cat >> /root/.ssh/config <<'EOF'
    Host storagebox
        HostName u123456.your-storagebox.de
        User u123456
        Port 23
        IdentityFile /root/.ssh/id_ed25519
    EOF
    ssh storagebox ls
    

    De laatste opdracht moet de mappen van de Storage Box tonen zonder om een wachtwoord te vragen.

Of gebruik S3

Elke S3-dienst werkt: Amazon S3, Hetzner Object Storage, Backblaze B2 of Cloudflare R2. Maak een privébucket en een toegangssleutel die alleen die bucket mag lezen en schrijven. Gebruik in het volgende deel de S3-regels in backup.env in plaats van de regel voor de Storage Box:

RESTIC_REPOSITORY=s3:https://s3.eu-central-1.amazonaws.com/your-bucket/sendkettle
AWS_ACCESS_KEY_ID=your-access-key
AWS_SECRET_ACCESS_KEY=your-secret-key

Voor Hetzner Object Storage ziet het adres eruit als s3:https://fsn1.your-objectstorage.com/your-bucket/sendkettle.

De back-ups aanzetten

  1. Kopieer het instellingenbestand en maak een wachtwoord voor de back-ups:

    cp /var/www/sendkettle/deploy/backup.env.example /etc/sendkettle/backup.env
    chmod 600 /etc/sendkettle/backup.env
    openssl rand -base64 32 > /etc/sendkettle/restic-password
    chmod 600 /etc/sendkettle/restic-password
    cat /etc/sendkettle/restic-password
    
  2. Bewaar het wachtwoord dat de laatste opdracht toont in je wachtwoordmanager. Zonder dat wachtwoord kan niemand de back-ups lezen, jij ook niet.

  3. Open de instellingen met nano /etc/sendkettle/backup.env. Laat voor een Storage Box RESTIC_REPOSITORY=sftp:storagebox:sendkettle staan zoals het is. Vervang het voor S3 door de S3-regels van hierboven. Sla op met Ctrl+O en Enter, en sluit met Ctrl+X.

  4. Optioneel: gebruik je een check-in-dienst zoals Healthchecks.io, zet het ping-adres dan bij PING_URL=. Je krijgt een e-mail als de back-up van een nacht niet binnenkomt.

  5. Maak de back-upopslag aan en maak de eerste back-up:

    bash /var/www/sendkettle/deploy/backup.sh init
    bash /var/www/sendkettle/deploy/backup.sh
    

De laatste regel moet Backup finished. zeggen. Vanaf nu voert cron dit elke nacht uit; de uitvoer komt in /var/log/sendkettle-backup.log. Restic bewaart 7 dagelijkse, 4 wekelijkse en 6 maandelijkse back-ups (wijzig KEEP_DAILY, KEEP_WEEKLY en KEEP_MONTHLY in backup.env) en controleert de back-upopslag elke zondag.

Een herstel testen

Een back-up die je nooit hebt teruggezet, is alleen een hoop. Test het nu, en daarna om de paar maanden:

bash /var/www/sendkettle/deploy/backup.sh restore-test

Het script zet de nieuwste back-up terug in een tijdelijke map, controleert de database, telt de gebruikers, kijkt of .env een APP_KEY heeft en ruimt de map weer op. Het eindigt met Restore test passed en de datum van de back-up. bash /var/www/sendkettle/deploy/backup.sh snapshots toont alle back-ups.

Een back-up terugzetten

Ben je de server kwijt, maak dan een nieuwe (stap 1 tot en met 3, met hetzelfde domein) en doe daarna dit:

  1. Stel de toegang tot de Storage Box of S3 opnieuw in (het deel over de SSH-sleutel in Een Storage Box instellen, of de S3-regels), zet hetzelfde restic-wachtwoord in /etc/sendkettle/restic-password en kopieer backup.env zoals hierboven beschreven.

  2. Zet de back-up terug in een aparte map en zet de bestanden op hun plek:

    bash /var/www/sendkettle/deploy/backup.sh restore /root/restore
    supervisorctl stop sendkettle-worker:*
    cd /var/www/sendkettle
    rm -f database/database.sqlite-wal database/database.sqlite-shm
    cp /root/restore/var/backups/sendkettle/database.sqlite database/database.sqlite
    cp /root/restore/var/backups/sendkettle/env .env
    cp -a /root/restore/var/www/sendkettle/storage/app/. storage/app/
    chown -R deploy:deploy database .env storage
    chmod 600 .env
    bash deploy/update.sh --no-pull
    supervisorctl start sendkettle-worker:*
    
  3. Gebruikt de nieuwe server een ander domein, voer het installatiescript dan opnieuw uit met het nieuwe --domain. Het past APP_URL aan en houdt de teruggezette APP_KEY.

Bewaar ook ergens anders een kopie

Een Storage Box bij hetzelfde bedrijf als je server beschermt je tegen een kapotte server, maar niet tegen het kwijtraken van je Hetzner-account. Neem daarom elke maand ook een kopie mee naar huis:

bash /var/www/sendkettle/deploy/backup.sh export

Dit schrijft één .tar.gz-bestand en toont de scp-opdracht die je op je eigen computer uitvoert om het te downloaden. Het bestand bevat .env met je APP_KEY, dus bewaar het op een privéplek en verwijder het daarna van de server met rm /var/backups/sendkettle/sendkettle-export-*.tar.gz.

Je kunt ook een tweede back-upopslag bij een ander bedrijf gebruiken: kopieer /etc/sendkettle/backup.env naar een tweede bestand met een S3-adres en voer SENDKETTLE_BACKUP_CONFIG=/etc/sendkettle/backup-s3.env bash /var/www/sendkettle/deploy/backup.sh uit vanaf een tweede cron-regel.

Bewaking

  • Systeemstatus: open in SendKettle Help en dan Systeemstatus. Daar zie je of de database, de verzendprovider, de queue-worker, de planner, de afleveringen, de bounce-webhooks en de opslag van afbeeldingen werken. Zie Kennisbank en ondersteuning.
  • Productiechecklist: Instellingen, Account, Productiechecklist (stap 7).
  • Uptime: maak een gratis account bij een uptime-dienst zoals UptimeRobot of Better Stack en voeg een HTTP(S)-controle toe voor https://news.example.com/up. Die pagina antwoordt met status 200 zolang de app draait. Je krijgt een e-mail of sms als hij niet meer antwoordt.
  • Back-ups: de optionele PING_URL in backup.env waarschuwt je als een nachtelijke back-up ontbreekt.

Problemen oplossen

Log eerst in op de server: ssh root@203.0.113.10.

De queue draait niet

Kenmerken: campagnes blijven op Bezig met versturen staan, testcampagnes komen niet aan, Systeemstatus meldt dat taken wachten.

  1. Controleer de worker:

    supervisorctl status sendkettle-worker:*
    

    Er moet RUNNING staan. Zo niet, start hem met supervisorctl start sendkettle-worker:*.

  2. Stopt hij steeds, lees dan zijn logbestand: tail -n 50 /var/www/sendkettle/storage/logs/worker.log.

  3. Mislukte taken zie je met sudo -u deploy php8.4 /var/www/sendkettle/artisan queue:failed. Probeer ze opnieuw nadat je de oorzaak hebt opgelost, met sudo -u deploy php8.4 /var/www/sendkettle/artisan queue:retry all.

De planner draait niet

Kenmerken: ingeplande campagnes blijven op Ingepland staan, automatiseringen gaan niet verder, de checklist toont Planner als mislukt.

  1. Controleer of het cron-bestand bestaat: cat /etc/cron.d/sendkettle. Ontbreekt het, voer het installatiescript dan opnieuw uit.

  2. Voer de planner één keer met de hand uit en lees de uitvoer:

    cd /var/www/sendkettle && sudo -u deploy php8.4 artisan schedule:run
    
  3. Controleer of cron zelf draait: systemctl status cron.

E-mails blijven hangen

  1. Controleer eerst de queue-worker (hierboven).
  2. Open Instellingen en gebruik Testmail versturen. De melding toont de fout van je provider, bijvoorbeeld een verkeerd wachtwoord of een afzenderadres dat SES niet heeft geverifieerd.
  3. Zit je nog in de SES-sandbox? Dan krijgen alleen geverifieerde adressen e-mail. Zie De SES-sandbox verlaten.
  4. De SMTP-poort moet vanaf de server bereikbaar zijn: nc -zv email-smtp.eu-central-1.amazonaws.com 587 moet succeeded zeggen. Hostingbedrijven blokkeren bij nieuwe accounts vaak uitgaande mailpoorten. DigitalOcean blokkeert 25, 465 en 587; Hetzner blokkeert 25 en 465. SES luistert ook op poort 2587: zet Poort in Instellingen op 2587 met STARTTLS (port 587) en test opnieuw. Of vraag de ondersteuning van het hostingbedrijf om de poort vrij te geven.
  5. Controleer Max. e-mails per minuut in Instellingen: met een lage waarde duurt een grote campagne uren. Met meerdere werkruimtes begrenst MAIL_FAIR_SHARE_PER_MINUTE ook elk van hen.
  6. Een campagne die langer dan een paar minuten Ontvangerslijst klaarzetten toont, wordt door de planner weer opgepakt (die moet draaien, zie hierboven). Na drie mislukte pogingen wordt ze gepauzeerd met een melding; klik op Verzenden hervatten zodra de oorzaak (vaak de queue-worker) is opgelost.

500-fouten en waar de logbestanden staan

Een pagina "Serverfout" betekent dat er in de app iets misging. De details staan in de logbestanden:

Logbestand Waar
SendKettle /var/www/sendkettle/storage/logs/laravel-JJJJ-MM-DD.log (één per dag)
Queue-worker /var/www/sendkettle/storage/logs/worker.log
nginx /var/log/nginx/sendkettle.error.log
PHP /var/log/php8.4-fpm.log
Back-ups /var/log/sendkettle-backup.log

Toon de laatste regels van het logbestand van vandaag:

tail -n 50 /var/www/sendkettle/storage/logs/laravel-$(date +%F).log

Zet APP_DEBUG op een live server niet aan om fouten te zien; lees het logbestand. Voer na een wijziging in .env altijd config:cache uit (zie Instellingen in het .env-bestand). Een "502 Bad Gateway" betekent dat PHP niet draait: systemctl restart php8.4-fpm.

Problemen met rechten

Kenmerken: "Permission denied" of "failed to open stream" in het logbestand, uploads die mislukken, of Opslag is beschrijfbaar dat faalt in de checklist. Dit gebeurt meestal na een opdracht als root in /var/www/sendkettle. Voer artisan en composer altijd uit als deploy (sudo -u deploy ...), zoals in deze handleiding.

Zo herstel je de rechten:

chown -R deploy:deploy /var/www/sendkettle
chmod -R u+rwX,g+rwX,o-rwx /var/www/sendkettle/storage /var/www/sendkettle/bootstrap/cache /var/www/sendkettle/database
chmod o+x /var/www/sendkettle/storage /var/www/sendkettle/storage/app
chmod -R o+rX /var/www/sendkettle/storage/app/public
chmod 600 /var/www/sendkettle/.env

Het installatiescript opnieuw uitvoeren doet hetzelfde.

SQLite of MySQL

De installatie gebruikt SQLite: de hele database is één bestand, er is geen databaseserver om bij te houden, en een back-up is één kopie van dat bestand. Voor één server en een lijst van tienduizenden contacten is dat ruim genoeg. Het script zet de WAL-modus van SQLite aan, zodat de website, de queue-worker en de planner tegelijk kunnen werken, en draait één queue-worker.

Kies alleen voor MySQL of PostgreSQL als je meerdere app-servers wilt, of meerdere queue-workers die op volle snelheid versturen. SendKettle ondersteunt ze via de gewone Laravel-instellingen DB_*, maar deze handleiding en de scripts (ook backup.sh) zijn voor SQLite geschreven. Zie Installatie.