ServBay Mailpit Service Configuratiegids

ServBay integreert het Mailpit-pakket en biedt een handige lokale mailserver, speciaal ontworpen voor ontwikkelaars om e-mailverzendfuncties van applicaties te testen en debuggen. In dit document lees je hoe je het Mailpit-pakket installeert, activeert en configureert in ServBay, inclusief de vier hoofdtabbladen: Common, SMTP, POP3 en Relay.

Overzicht van het Mailpit-pakket

Mailpit is een open-source tool die een gebruiksvriendelijke lokale SMTP/POP3-server en een intuïtieve webinterface biedt. Hiermee kun je alle e-mails die je applicatie verstuurt opvangen en op een centrale plek inzien—zoals inhoud, headers, en bijlagen—zonder dat testmails in echte mailboxen terechtkomen. Dit vereenvoudigt ontwikkel- en debugprocessen drastisch, zeker bij functies als gebruikersregistratie, wachtwoordherstel en notificaties waarbij e-mails worden verstuurd.

Mailpit is als kernpakket geïntegreerd in ServBay. Je kunt het eenvoudig installeren en beheren, waarbij je profiteert van het krachtige PKI-systeem van ServBay dat automatisch SSL/TLS-certificaten configureert voor een veilige testomgeving.

Mailpit-pakket installeren en activeren

Voor je Mailpit als lokale mailserver kunt gebruiken, dient het pakket in ServBay geïnstalleerd en geactiveerd te zijn.

1. Open de ServBay-applicatie.
2. Kies Pakketten in de linkernavigatiebalk.
3. Zoek in de pakkettenlijst naar de categorie Algemene services.
4. Zoek het Mailpit-pakket.
5. Is Mailpit nog niet geïnstalleerd? Klik dan op de groene installatieknop ernaast.
6. Na installatie kun je het meteen activeren met de aan/uit-schakelaar.

Dankzij het krachtige PKI-systeem van ServBay worden de benodigde SSL-certificaten automatisch gegenereerd en geconfigureerd voor zowel de webinterface van Mailpit als de SMTP- en POP3-diensten. Je kunt dus direct STARTTLS of SSL/TLS-versleuteling inschakelen, zonder handmatig certificaten aan te hoeven vragen of in te stellen.

Webmailbeheerinterface

Mailpit wordt geleverd met een krachtige webinterface voor het bekijken en beheren van binnengekomen e-mails. ServBay configureert deze automatisch voor je. Zodra Mailpit is geactiveerd, kun je deze rechtstreeks via je browser benaderen:

Bezoekadres: https://mail.servbay.host

Via deze interface kun je eenvoudig door de ontvangen e-maillijst bladeren, e-mails gedetailleerd inzien (inclusief HTML-view, platte tekst, broncode), e-mails zoeken, verwijderen en meer.

Mailpit-pakket configureren

ServBay biedt een grafische interface voor het instellen van de Mailpit-parameters. Navigeer hiervoor in de linkerkolom naar Mail en klik op Mailpit Service Config. Je vindt daar vier hoofd-tabbladen: Common, SMTP, POP3 en Relay.

1. Common-tabblad

Het Common-tabblad bevat algemene instellingen en gedragingen van Mailpit:

• Max Messages: Het maximaal aantal e-mails dat de Mailpit-server mag opslaan. Bij overschrijding worden de oudste berichten automatisch verwijderd.
• Max Age: De maximale tijd (in dagen) dat e-mails op de Mailpit-server blijven staan. Ouder e-mails worden automatisch gewist.
• SpamAssassin: Activeer of deactiveer SpamAssassin voor spamfiltering. Als dit aanstaat, markeert Mailpit ontvangen spam-mails.
• Webhook URL: Stel een webhook-URL in. Bij een nieuwe e-mail stuurt Mailpit een HTTP POST-verzoek naar deze URL om andere systemen te informeren. Ideaal voor integratie van automatische tests of notificaties.
• Webhook Limit: Het maximum aantal e-mails per webhook-notificatie.

2. SMTP-tabblad

TIP

Dankzij het krachtige PKI-systeem van ServBay worden SSL-certificaten standaard automatisch aangemaakt en geconfigureerd. Je kunt rechtstreeks STARTTLS of SSL/TLS-verbindingen inschakelen zonder extra SSL-certificaten aan te vragen of te installeren.

Het SMTP-tabblad is voor het configureren van Mailpit als SMTP-server. Je applicatie koppelt hieraan om testmails te versturen:

• SMTP Port: Het poortnummer waarop Mailpit SMTP luistert. Stel je applicatie in op deze poort op 127.0.0.1 of localhost. Standaard is dit 1025.
• STARTTLS: Inschakelen of uitschakelen van STARTTLS-encryptie. Hiermee kun je na verbinding upgraden naar beveiligde communicatie.
• SSL/TLS: Zet SSL/TLS-encryptie aan of uit. Hierbij wordt direct na verbinding alles versleuteld.
• Username: Inlognaam voor SMTP (optioneel). Als je dit instelt, moet de applicatie ermee inloggen voor verzenden.
• Password: Wachtwoord voor SMTP-server (optioneel). Wordt gebruikt samen met Username.
• Max Recipients: Maximale ontvangers die per e-mail zijn toegestaan; voorkomt te grote verzendlijsten per boodschap.
• Allowed Recipients: Beperk e-mailontvangers tot een lijst van adressen of domeinen (optioneel). Leeg laten betekent: elke ontvanger toegestaan; ingevuld betekent: alleen genoemde adressen zijn toegestaan.

3. POP3-tabblad

TIP

Dankzij het krachtige PKI-systeem van ServBay worden SSL-certificaten standaard automatisch aangemaakt en geconfigureerd. Je kunt direct SSL/TLS-versleuteling inschakelen zonder extra installatie of configuratie van certificaten.

Het POP3-tabblad is voor het instellen van Mailpit als POP3-server. Test je applicatie het ontvangen van e-mails? Laat deze dan verbinden met de POP3-dienst:

• Enable POP3 Server: Zet de POP3-server van Mailpit aan of uit.
• POP3 Server Port: Het poortnummer waarop Mailpit POP3 luistert. Standaard: 1110.
• Username: Gebruikersnaam voor POP3 (optioneel). Moet ingevuld worden door clients bij authenticatie.
• Password: Wachtwoord voor POP3 (optioneel). Wordt samen met Username gebruikt.
• SSL/TLS: Zet SSL/TLS-encryptie aan of uit.

4. Relay-tabblad

Met het Relay-tabblad stel je in dat Mailpit bepaalde (of alle) ontvangen e-mails doorstuurt naar een externe SMTP-server:

• Enable SMTP Relay: Zet de relayfunctie aan of uit.
• Host: Het adres van de externe SMTP-server (bijvoorbeeld: smtp.gmail.com, smtp.sendgrid.net).
• Port: Het poortnummer van de externe SMTP-server. Meestal 25 (standaard SMTP), 465 (SMTPS), of 587 (Submission).
• STARTTLS: Zet STARTTLS-versleuteling naar de relayserver aan of uit.
• Allow Insecure: Sta verbinding toe naar SMTP-servers met niet-vertrouwde certificaten (niet aanbevolen voor productie gebruik).
• Auth: Kies de authenticatiemethode voor de relayserver. Gebruikelijk zijn Login (gebruikersnaam en wachtwoord), Plain (vergelijkbaar met Login), of CRAM-MD5 (uitdaging/respons-methode).
• Username: Gebruikersnaam voor de externe SMTP-server.
• Password: Wachtwoord voor de externe SMTP-server.
• Return Path: Het retourpad voor doorgestuurde e-mails (Return-Path header).
• Allowed Recipients: Optionele lijst van ontvangers of domeinen die doorgestuurd mogen worden.
• Blocked Recipients: Optionele lijst van ontvangers of domeinen die juist niet doorgestuurd mogen worden.
• Relay All: Indien aangevinkt, zal Mailpit proberen alle ontvangen mails door te sturen (onder voorbehoud van de Allowed/Blocked Recipients-regels).
• Relay Matching: Wanneer geselecteerd, stuurt Mailpit alleen e-mails door die voldoen aan de Allowed of Blocked Recipients-instellingen.

Instellingen opslaan

Na het aanpassen van de Mailpit-configuratie klik je onderaan op de knop Save om je instellingen op te slaan.

Met de Reset-knop herstel je alle opties naar de standaardinstellingen van Mailpit.

Veelgestelde vragen (FAQ)

• Q: Waarom verschijnen de mails van mijn applicatie niet in Mailpit?
  • A: Controleer of je applicatie correct geconfigureerd is voor mailverzending: staat SMTP-host en poort naar het adres waar ServBay met Mailpit draait (127.0.0.1 of localhost, standaard poort 1025)? Kijk ook of het Mailpit-pakket in ServBay daadwerkelijk is gestart. Je vindt de status terug in het pakketbeheer van ServBay.
• Q: Moet ik een SSL-certificaat instellen voor Mailpit?
  • A: Nee, dat is niet nodig. Dankzij het krachtige PKI-systeem van ServBay worden alle benodigde certificaten voor de Mailpit-webinterface en SMTP/POP3-diensten automatisch aangemaakt en geconfigureerd. Je hoeft alleen de encryptie-opties in het configuratiescherm te activeren.
• Q: Wat zijn de standaard gebruikersnaam en wachtwoord voor de Mailpit-webinterface?
  • A: Standaard vraagt de Mailpit-webinterface via https://mail.servbay.host niet om een gebruikersnaam of wachtwoord. Ook voor SMTP en POP3 zijn standaard geen credentials vereist. Wil je toch authenticatie afdwingen voor SMTP of POP3, stel dan een gebruikersnaam en wachtwoord in via de juiste tabbladen.

Samenvatting

Met het geïntegreerde Mailpit-pakket in ServBay bouw je moeiteloos een lokale e-mailtestomgeving. Door SMTP-, POP3- en Relay-instellingen aan te passen én te profiteren van de overzichtelijke webinterface, verbeter je de efficiëntie en het gemak van e-mailfunctionaliteit tijdens het ontwikkelen.

Let op: na het wijzigen van de instellingen kan het nodig zijn het Mailpit-pakket te herstarten voordat de wijzigingen van kracht worden. In het pakketbeheer van ServBay kun je Mailpit opzoeken en op de herstartknop klikken.