Email Setup
MaestroHub uses email for features that require outgoing mail, such as self-service password resets and trial license extension requests. The Email Setup page lets administrators configure one or more SMTP server connections and control which configuration is actively used.
Open the page from System Management > Email Configuration tab.
Why Configure Email?
Email is optional — MaestroHub runs without it — but the following features depend on an active email configuration:
| Feature | What It Does | Without Email |
|---|---|---|
| Password Reset | Sends a reset link to the user's email so they can set a new password from the login page. | The "Forgot Password" page shows a notice that password reset is unavailable. Administrators must reset user passwords manually via the CLI. |
| Trial License Extension | Sends a request to the MaestroHub support team on behalf of the administrator. | The extension request cannot be submitted (returns a service-unavailable error). |
All other platform features — pipelines, connections, models, dashboards — work normally regardless of email configuration.
The following features are planned for upcoming releases and will also require an active email configuration:
- Notification Preferences — Per-user email notification settings for system updates, error alerts, and workflow status changes.
Multiple configurations — You can create several email configurations (e.g. one for production and one for staging) and switch between them without losing any settings.
Managing Configurations
When at least one configuration exists, a Configuration dropdown appears at the top of the page. Use it to switch between saved configurations or select Add New Configuration to create another one.
Each configuration in the dropdown shows its name, provider type, and whether it is currently active. Only one configuration can be active at a time.
Activating and Deactivating
- Set as Active — Select an inactive configuration from the dropdown and click Set as Active to make it the one MaestroHub uses for sending emails.
- Deactivate — Click Deactivate on the currently active configuration to stop MaestroHub from sending emails through it. When no configuration is active, email delivery is disabled.
Deleting a Configuration
Inactive configurations can be deleted directly from the configuration dropdown. Active configurations must be deactivated first. Deletion is permanent and requires you to type the configuration name to confirm.
SMTP Server Settings
The first card collects the connection details for your SMTP server.
| Field | Description |
|---|---|
| Configuration Name | A friendly label to identify this configuration (e.g. "Primary SMTP Server"). |
| SMTP Host | The hostname or IP address of your SMTP server (e.g. smtp.gmail.com). |
| Port | The port number. Common values: 587 for STARTTLS, 465 for TLS/SSL, 25 for unencrypted. |
| Security | The encryption protocol used to connect to the server. |
| Auth Method | The authentication mechanism the server expects. |
Security Protocols
| Protocol | Typical Port | Description |
|---|---|---|
| TLS/SSL | 465 | Encrypted connection from the start. |
| STARTTLS | 587 | Starts unencrypted, then upgrades to TLS. This is the most common option. |
| None | 25 | No encryption. Not recommended for production use. |
Authentication Methods
| Method | Description |
|---|---|
| PLAIN | Sends credentials in plain text (safe when combined with TLS/STARTTLS). Most common option. |
| LOGIN | Similar to PLAIN but uses a different handshake. Required by some older servers. |
| CRAM-MD5 | Challenge-response authentication that avoids sending the password directly. |
Authentication
Enter the username and password for your SMTP account.
- Username — Usually your full email address.
- Password — Your account password or an app-specific password. For Gmail and Google Workspace, you must generate an App Password instead of using your regular password.
Sender Information
Configure how outgoing emails appear to recipients.
| Field | Description |
|---|---|
| From Email | The email address that appears in the "From" field (e.g. noreply@yourdomain.com). |
| From Name | The display name shown alongside the from address (e.g. "MaestroHub"). |
A preview at the bottom of this section shows exactly how the sender will appear to recipients — for example: MaestroHub <noreply@yourdomain.com>.
Testing the Configuration
Before saving, you can verify that your settings work by sending a test email. Enter a recipient email address in the Test Configuration card and click Send Test. The test uses the current form values, so you can test before committing to a save.
If the test email arrives successfully, your configuration is correct. If it fails, double-check the host, port, credentials, and security protocol.
Test emails are sent using the values currently entered in the form, even if they have not been saved yet. This lets you experiment with settings before committing, but keep in mind that unsaved changes will be lost if you navigate away.
Saving
Click Save Changes (or Create Configuration for a new one) at the bottom of the page to persist your settings. The first configuration you create is automatically set as active and default.