User ManualPodWarden
Settings: System
System configuration including SMTP email and OIDC single sign-on
What you see
URL: /settings (System tab)
The System tab under Settings contains core configuration for email notifications and single sign-on. This is the first tab in the settings page.
Fields
SMTP configuration
| Field | Description |
|---|---|
| SMTP host | Hostname of the mail server (e.g. smtp.gmail.com) |
| SMTP port | Port number (e.g. 587 for STARTTLS, 465 for SSL) |
| From address | The email address that appears in the "From" field |
| Username | SMTP authentication username |
| Password | SMTP authentication password (stored encrypted) |
OIDC configuration
| Field | Description |
|---|---|
| Issuer URL | The OpenID Connect discovery URL (e.g. https://sso.example.com/realms/myrealm) |
| Client ID | The OIDC client identifier registered with your identity provider |
| Client secret | The OIDC client secret (stored encrypted) |
Available actions
| Action | What it does |
|---|---|
| Save | Persists all changes to the system configuration |
| Test SMTP | Sends a test email to verify the SMTP settings are correct. Reports success or the error message from the mail server |
| Test OIDC | Attempts to fetch the OIDC discovery document from the issuer URL and validates the client credentials. Reports success or the specific error |
Notes
- OIDC configuration is required for the Sign in with SSO button to appear on the login page.
- SMTP configuration is optional. Without it, PodWarden cannot send email notifications.
- Changes to OIDC settings take effect immediately -- no restart required.
Related docs
- Login -- How authentication flows use these settings
- Settings -- Users -- Local user accounts as an alternative to OIDC
- Settings -- Tailscale -- Next settings tab