Skip to content

Privacy-first password manager with built-in email aliasing. Fully encrypted and self-hostable.

Add SMTP TLS instructions to self-hosted docs

Leendert de Borstc64238dd799e
diff --git a/docs/installation/docker-compose/index.md b/docs/installation/docker-compose/index.md
index 2c74bc1e6..69fb30cde 100644
--- a/docs/installation/docker-compose/index.md
+++ b/docs/installation/docker-compose/index.md
@@ -189,6 +189,19 @@ Important: DNS propagation can take up to 24-48 hours. During this time, email d
If you encounter any issues, feel free to join the [Discord chat](https://discord.gg/DsaXMTEtpF) to get help from other users and maintainers.
+### Optional: SMTP TLS (STARTTLS)
+
+By default, SMTP TLS is disabled (`SMTP_TLS_ENABLED: "false"`). This does NOT significantly impact email deliverability: most email providers will still deliver to your server. However, if you want to enable TLS for SMTP connections:
+
+1. Obtain a valid TLS certificate for your mail hostname (e.g., `mail.example.com`)
+2. Combine the certificate and private key into a single `.pem` file
+3. Place the `.pem` file in your `./certificates/smtp/` volume directory
+4. Update your `docker-compose.yml` to set `SMTP_TLS_ENABLED: "true"`
+5. Restart the container: `docker compose down && docker compose up -d`
+
+{: .note }
+If you have multiple mail domains, use a single certificate with Subject Alternative Names (SANs) covering all domains. If TLS is enabled but no valid certificate is found, the service will log a warning (visible in admin panel > general logs) and continue in non-TLS mode.
+
---
## 4. Troubleshooting
diff --git a/docs/installation/script/index.md b/docs/installation/script/index.md
index ed23b4f53..cdc5074ae 100644
--- a/docs/installation/script/index.md
+++ b/docs/installation/script/index.md
@@ -63,7 +63,7 @@ To generate a valid external TLS/SSL certificate for AliasVault, you can use Let
- Port 80 and 443 on your server must be open and accessible from the internet
- A registered domain name with an A record pointing to your server's public IP address (e.g. mydomain.com)
-### Steps
+### Enable Let's Encrypt SSL
1. Run the install script with the `configure-ssl` option
```bash
@@ -177,6 +177,19 @@ Important: DNS propagation can take up to 24-48 hours. During this time, email d
If you encounter any issues, feel free to join the [Discord chat](https://discord.gg/DsaXMTEtpF) to get help from other users and maintainers.
+### Optional: SMTP TLS (STARTTLS)
+
+By default, SMTP TLS is disabled. This does NOT significantly impact email deliverability: most email providers will still deliver to your server. However, if you want to enable TLS for SMTP connections:
+
+1. Manually obtain a TLS certificate for your mail hostname (e.g., `mail.example.com`) - (there is no install script helper for this yet)
+2. Combine the certificate and private key into a single `.pem` file
+3. Place the `.pem` file in the `./certificates/smtp/` directory
+4. Edit your `.env` file and set `SMTP_TLS_ENABLED=true`
+5. Restart the SMTP service: `./install.sh restart smtp`
+
+{: .note }
+If you have multiple mail domains, use a single certificate with Subject Alternative Names (SANs) covering all domains. If TLS is enabled but no valid certificate is found, the service will log a warning (visible in admin panel > general logs) and continue in non-TLS mode.
+
---
## 4. Configure Account Registration