Nº 01Anleitung
Test-Mails mit Mailpit abfangen.
Eine Staging-Seite soll keine Bestellbestätigungen an echte Kundinnen und Kunden schicken. Mailpit ist ein Test-Postfach im Projekt: Die Anwendung sendet wie immer, die Mails bleiben in der Instanz.
Stand:
02Anleitung
Was Mailpit macht
Mailpit läuft als eigener Container im Projekt, nimmt Mails per SMTP an und zeigt sie in einer Weboberfläche. Die Anwendung erreicht es unter dem Host mailpit auf Port 1025. Zugangsdaten braucht es nicht.
Auf Envbay kommt eine zweite Sicherung dazu: Die Mailports 25, 465 und 587 sind nach außen gesperrt. Eine vergessene SMTP-Einstellung kann also nichts verschicken.
03Anleitung
Schritt für Schritt
- 01
Mailpit einschalten
Beim Anlegen eines Projekts haken Sie im Assistenten im Schritt „Projekt & Dienste“ bei den Diensten Mailpit an. In einem bestehenden Projekt öffnen Sie den Tab „Dienste“ und klicken in der Kachel „Mailpit“ auf „Mailpit hinzufügen“. Das dauerte in unserem Test knapp fünf Sekunden. Envoryx erstellt dabei die Anwendungscontainer mit den neuen Variablen neu.
- 02
Was die Anwendung bekommt
Envoryx übergibt die Verbindung als Umgebungsvariablen. In unserem Test standen im Terminal des Projekts diese sieben:
MAILER_DSN=smtp://mailpit:1025 MAIL_ENCRYPTION=null MAIL_HOST=mailpit MAIL_MAILER=smtp MAIL_PORT=1025 SMTP_HOST=mailpit SMTP_PORT=1025 - 03
Laravel
Laravel liest
MAIL_*aus der Umgebung, Sie müssen nichts einstellen. Die übergebenen Werte gewinnen gegen Ihre.env. Zum Testen im Terminal des Projekts:php artisan tinker --execute="Mail::raw('hello', fn (\$m) => \$m->to('test@example.com')->subject('Mailpit test'));" - 04
Symfony
Symfony liest
MAILER_DSNaus der Umgebung. In der Symfony-Vorlage ist der Mailer schon installiert. Der Testbefehl gibt bei Erfolg nichts aus, die Mail mit dem Betreff „Testing transport“ liegt danach im Postfach:php bin/console mailer:test test@example.com - 05
WordPress und älteres PHP
Solange Mailpit im Projekt aktiv ist, landet auch die PHP-Funktion
mail()dort. WordPress braucht deshalb kein SMTP-Plugin. Beide Befehle lieferten in unserem Testbool(true), und beide Mails lagen im Postfach:wp eval 'var_dump(wp_mail("test@example.com", "WP test", "hello"));' php -r 'var_dump(mail("test@example.com", "mail() test", "hello"));' - 06
Postfach öffnen
Öffnen Sie im Projekt den Tab „Dienste“ und klicken Sie in der Kachel „Mailpit“ auf die Adresse in der Zeile „Postfach“. Die Adresse besteht aus Projektname und
-mailpit. Ohne Anmeldung an der Instanz antwortet sie mit „Sign in required“.https://shop-mailpit.<kunde>.envbay.dev
04Anleitung
Was Sie wissen sollten
- Ein Neustart des Projekts leert das Postfach. In unserem Test lagen vorher zwei Mails darin, danach keine.
- Ohne Mailpit gibt es im Projekt kein Mailprogramm:
mail()undwp_mail()liefern dannfalse. Dasselbe gilt, nachdem Sie Mailpit über „Mailpit entfernen“ wieder herausgenommen haben. - Ein Gast-Link öffnet die Seite des Projekts, nicht das Postfach. Wer die Mails sehen soll, braucht ein Konto in der Instanz.
- Mailpit fängt ab, was per SMTP oder über
mail()ankommt. Verschickt Ihre Anwendung über die HTTP-Schnittstelle eines Mail-Dienstes, geht das an Mailpit vorbei. Stellen Sie im Staging dann auf SMTP oder einen Log-Treiber um. - Die Absender der Testmails waren in unserem Test
hello@example.com(Laravel),from@example.org(Symfony),wordpress@mit der Projektadresse (WordPress) undphp@envoryx.localhost(mail()).
Alle Schritte dieser Anleitung haben wir am 10. November 2026 auf einer Envbay-Instanz im Plan Starter ausgeführt: Envoryx 0.46.7, Mailpit 1.31, Laravel 13, die Symfony-Vorlage und WordPress 7.1 mit PHP 8.5.
04FAQ
Häufige Fragen.
Q.01Kann ich von der Instanz echte Mails verschicken?
Q.02Brauche ich Zugangsdaten für Mailpit?
Q.03Brauche ich für WordPress ein SMTP-Plugin?
05Ratgeber
Weiterlesen
- Laravel Staging ServerStaging für Laravel mit Datenbank, Redis, Mailpit und HTTPS-Adresse, ohne selbst einen Server zu pflegen.Laravel Staging
- Laravel in 10 MinutenSchritt für Schritt: Instanz öffnen, Laravel-Projekt anlegen, Seite aufrufen und per SSH in der IDE arbeiten.Ratgeber
- WordPress-StagingSchritt für Schritt zur WordPress-Testseite mit eigener HTTPS-Adresse, Gast-Link für die Abnahme und Umzug einer bestehenden Seite.Ratgeber
Selbst ausprobieren.
Plan wählen, bestellen, Instanz öffnen. Preise brutto inklusive 19 % MwSt.