Installera Mailpit på CasaOS med den officiella Docker-avbildningen axllent/mailpit, port 8025 för webbinkorgen och port 1025 för SMTP. Behåll /data endast om du vill att meddelanden och inställningar ska överleva när containern återskapas.
Den gamla BigBearCasaOS-guiden är fortfarande användbar som ett exempel med ett klick, men den aktuella Mailpit-dokumentationen från uppströmsprojektet innehåller nu den exakta Docker-avbildningen, alternativet för en beständig databas, autentiseringsalternativ samt TLS-/reläinställningar. Dessa bör ligga till grund för 2026 års guide.
Vad Mailpit är till för
Mailpit är en lokal SMTP-testserver för utvecklare. Program skickar testmejl till Mailpit i stället för till en riktig e-postleverantör, och du granskar meddelandena i en webbläsare.
Det är inte en vanlig produktionsbrevlåda eller en e-postserver som ska vara åtkomlig från internet.
Använd den officiella Docker-avbildningen
Den aktuella Docker-guiden för Mailpit dokumenterar:
axllent/mailpitPortmappning i CasaOS
- 8025/TCP: Mailpits webbgränssnitt
- 1025/TCP: SMTP-mottagare
Om en annan tjänst redan använder någon av värdportarna kan du ändra porten på värdsidan, men behålla porten på containersidan oförändrad.
Grundläggande inställningar för en anpassad CasaOS-app
image: axllent/mailpit
restart: unless-stopped
ports:
- "8025:8025"
- "1025:1025"Öppna http://CASAOS-IP:8025 när tjänsten har startat.
Anslut ditt program till Mailpit
För en annan container i samma Docker-nätverk använder du Mailpits tjänste- eller containernamn och port 1025. För ett program i det lokala nätverket använder du CasaOS-värdens IP-adress och den publicerade SMTP-värdporten.
Behåll endast meddelanden om du behöver det
Den aktuella Mailpit-dokumentationen stöder en SQLite-databas under /data med:
MP_DATABASE=/data/mailpit.dbMappa en CasaOS-AppData-mapp till /data om du vill att meddelandehistoriken ska överleva när containern ersätts.
Håll Mailpit privat
En testinkorg kan innehålla länkar för återställning av lösenord, API-aviseringar och programdata. Exponera inte webbgränssnittet eller en SMTP-lyssnare utan autentisering direkt mot internet.
Den aktuella konfigurationsguiden för Mailpit dokumenterar HTTP-, SMTP- och POP3-autentisering samt TLS-alternativ.
När du inte behöver publicera port 1025
Om endast containrar i samma Compose-nätverk skickar e-post till Mailpit kan du utelämna publiceringen av SMTP-porten på värden och hålla den intern i Docker.
Guiden om Docker-nätverk förklarar samma isoleringsmodell.
Testa SMTP-vägen innan du kopplar in den i ditt program
När Mailpit har startat ska du kontrollera att webbgränssnittet öppnas och sedan skicka ett testmeddelande från en enkel SMTP-klient eller från ditt program. Om meddelandet visas direkt i Mailpits inkorg fungerar både nätverksvägen och SMTP-lyssnaren.
Om programmet rapporterar att anslutningen nekades ska du kontrollera att det använder rätt värdnamn utifrån sin egen nätverkskontext. En container bör vanligtvis använda Mailpits tjänstenamn, medan en bärbar dator i det lokala nätverket bör använda CasaOS-värdens IP-adress.
Använd autentisering endast när testet kräver det
Mailpit kan ta emot SMTP utan autentisering för enkel lokal utveckling, men de aktuella konfigurationsalternativen stöder även SMTP-autentisering och autentisering för webbgränssnittet. Aktivera detta när flera användare delar labbmiljön eller när tjänsten kan nås utanför ett enda betrott Docker-nätverk.
Håll testmejl åtskilda från produktionsmejl
Mailpit är utformat för att fånga upp meddelanden så att de inte av misstag når riktiga användare. Rikta uttryckligen utvecklings- och stagingprogram mot Mailpit och förvara produktionsuppgifter för SMTP i en separat konfiguration. På så sätt förhindrar du att ett testmejl för återställning av lösenord eller en flod av aviseringar når kunderna.
Ange en meddelandegräns för långvariga labbmiljöer
Mailpit kan behålla tusentals meddelanden. I en kontinuerligt körande CI- eller homelabmiljö bör du ange ett rimligt maximum och endast spara det du faktiskt behöver. Annars kan ett litet testverktyg långsamt förvandlas till ännu en databas som du måste underhålla.
Vanliga frågor
Vilka är Mailpits standardportar?
8025 för webbgränssnittet och 1025 för SMTP.
Skickar Mailpit riktiga e-postmeddelanden?
Dess huvudsakliga uppgift är att fånga upp testmejl lokalt. Det kan konfigureras för vidarebefordran eller relä, men det kräver en separat, uttrycklig konfiguration.
Behöver jag en databas?
Nej, inte för tillfälliga tester. Använd SQLite-databasesalternativet om du vill ha en beständig meddelandehistorik.
Bör jag exponera Mailpit offentligt?
Nej. Håll det i ett betrott nätverk eller skydda det med autentisering och TLS.
