2.6 KiB
2.6 KiB
Email Configuration
Overview
SilverLinux uses a centralized SMTP configuration for application email delivery.
Email is used for:
- Password resets
- User invitations
- Notifications
- System alerts
- Backup reports
- Future CI/CD notifications
Sender Address
noreply@silveressence.net
Purpose:
- Automated emails
- Application notifications
- No inbound processing required
SMTP Provider
Provider:
Gmail SMTP
Server:
smtp.gmail.com
Port:
587
Security:
STARTTLS
Authentication:
Login
Secret Storage
SMTP credentials are stored in:
/srv/secrets/company.env
Variables:
SMTP_HOST
SMTP_PORT
SMTP_USERNAME
SMTP_PASSWORD
These values must never be committed to Git repositories.
Applications Using Email
OpenProject
Purpose:
- Password reset emails
- Work package notifications
- Mention notifications
- User invitations
Sender:
noreply@silveressence.net
Status:
Configured
Gitea
Purpose:
- Password reset emails
- Repository notifications
- User invitations
Sender:
noreply@silveressence.net
Status:
Configured
Backup System
Purpose:
- Backup success emails
- HTML backup report emails
- Operational backup notifications
Delivery:
- Postfix relay through Gmail SMTP
- Gmail App Password authentication
- TLS encryption
Status:
Configured and validated
Future Applications
Future services should use the centralized SMTP configuration whenever possible.
Examples:
- BaGet
- CI/CD notifications
- Alerting systems
Testing
OpenProject
Test by:
- Creating a user.
- Triggering a password reset.
- Verifying email delivery.
Gitea
Test by:
- Opening "Forgot Password".
- Requesting a password reset.
- Verifying email delivery.
Troubleshooting
OpenProject
View logs:
docker logs openproject
Gitea
View logs:
docker logs gitea
Gmail Authentication
Verify:
- App password is valid
- SMTP credentials match company.env
- STARTTLS is enabled
- Port 587 is used
Backup Reports
Verify:
- Postfix relay is active
- Gmail App Password authentication succeeds
- TLS delivery succeeds
- Backup wrapper sends the HTML report after backup completion
Security Notes
- Use Gmail App Passwords.
- Never use personal Gmail passwords.
- Store SMTP credentials only in company.env.
- Rotate credentials if they become exposed.
Related Documentation
- docs/secrets.md
- docs/security.md
- docs/backups.md
- openproject/README.md
- gitea/README.md