Admin: SMTP email
Configure outbound SMTP in self-hosted SlugBase under Admin → Settings for invites, password resets, and verification email.
What this is for
Self-hosted SlugBase sends transactional email through SMTP Email Configuration on the Settings admin page (the sidebar label is Settings; the in-page section title is SMTP Email Configuration). You use it for flows such as password reset, email verification, and optional Send invite email when creating users.
Before you start
- You need access to Admin (see Workspace admin overview).
- Have your mail provider’s host, port, credentials, and allowed From address. Many providers require an app-specific password or SMTP relay setup.
Environment variables for secrets like JWT_SECRET are documented in Configuration. SMTP itself is managed in the app as described here, not via Postmark-style env vars used in some hosted deployments.
How to configure SMTP
Open Settings
Under Admin, choose Settings.
Enable SMTP
Turn on Enable SMTP.
Enter server details
Fill SMTP Host, Port (often 587 for STARTTLS), Username/Email, and Password. If a password is already stored, the field may be masked—enter a new value only when you want to change it.
From identity
Set From Email and From Name as your recipients should see them.
TLS
Toggle Use TLS/SSL to match your provider’s requirements.
Save
Select Save SMTP Settings.
How to send a test message
The form shows your signed-in account email as the test destination. Select Send Test Email to verify delivery. If it fails, the app surfaces an error—double-check host, port, TLS, and credentials.
Verify
- Run Send Test Email successfully.
- Create a user with Send invite email (Members) and confirm the message arrives, or trigger a password reset from the login screen.
Troubleshooting
Related
Last updated 3 days ago
Built with Documentation.AI