PDNS Manager

SMTP & Welcome-Mail

Mails braucht der PDNS Manager für drei Dinge: Passwort-Reset, Welcome-Mail bei Selbst-Registrierung und gelegentliche Benachrichtigungen. Die SMTP-Konfiguration liegt im Panel (DB), nicht in der .env – das macht es einfach, im laufenden Betrieb umzustellen.

SMTP konfigurieren

Einstellungen → SMTP:

  • Host – z. B. mail.example.com oder ein externer Provider wie smtp.eu.mailgun.org.
  • Port – typisch 587 (STARTTLS) oder 465 (TLS).
  • Benutzer / Passwort – die SMTP-Credentials.
  • Absender – z. B. "PDNS Manager <[email protected]>".
  • Verschlüsselung – STARTTLS oder TLS.

Test-Mail verschicken

Im SMTP-Panel gibt es zwei Buttons:

  • Verbindung testen – versucht eine SMTP-Session aufzumachen, ohne wirklich was zu senden. Praktisch bei „klemmt der Login-User?".
  • Test-Mail senden – schickt eine echte Mail an eine eingegebene Adresse. Damit weißt du sicher, dass der ganze Pfad inkl. SPF/DKIM/Spam-Filter funktioniert.

Welcome-Mail (Selbst-Registrierung)

Wenn neue Nutzer sich selbst registrieren dürfen (ENABLE_REGISTRATION=true), kannst du ihnen eine Begrüßungsmail schicken lassen. Einstellungen → Welcome-Mail:

  • Aktiv – Schalter, ob die Mail überhaupt verschickt wird.
  • Subject – Mail-Betreff, mit Platzhaltern.
  • Body – Mail-Inhalt (Plain Text oder HTML), mit Platzhaltern.

Platzhalter

PlatzhalterWird ersetzt durch
{username}Der gewählte Username
{email}Die E-Mail-Adresse des Users
{login_url}Direkter Link zum Login (z. B. https://pdns.example.com/login)
{app_name}Der konfigurierte App-Name

Beispiel

Subject:  Willkommen bei {app_name}, {username}!

Hi {username},

dein Account ist eingerichtet. Du kannst dich ab sofort hier einloggen:

  {login_url}

Bei Fragen: einfach auf diese Mail antworten.

Viele Grüße,
das {app_name}-Team

Welche Mails noch verschickt werden

  • Passwort-Reset – wenn ein User auf /forgot-password seine Adresse einträgt, geht eine Mail mit kurzlebigem Reset-Token raus.
  • Admin-Reset – wenn ein Admin im User-Panel „Reset-Mail senden" klickt.

Häufige Probleme

SymptomLösung
„SMTP-Verbindung fehlgeschlagen"Falscher Port. Bei externen Providern fast immer 587/STARTTLS oder 465/TLS – nicht 25.
Verbindung geht, aber Mail kommt nicht anSPF/DKIM checken, Spam-Ordner prüfen, vom Provider die Send-Logs anschauen.
„Mail relaying denied"SMTP-Auth-User hat keine Erlaubnis, von der gewählten Absenderadresse zu senden. Andere Absenderadresse wählen oder beim Provider freischalten.
Hier ist noch kein Bild hinterlegt. Lege es unter src/assets/screenshots/<dateiname> ab und trage es in der Galerie-Liste ein.