docs: document direct compose workflow

This commit is contained in:
Eduardo David Paredes Vara
2026-07-25 11:20:27 +00:00
parent d64191865b
commit 3b7f2a2fa1
20 changed files with 247 additions and 482 deletions
+10 -9
View File
@@ -23,20 +23,21 @@ printf '%s' 'CAMBIA_ESTA_PASSWORD_SMTP' | sudo tee /opt/mail-relay/secrets/relay
sudo chmod 600 /opt/mail-relay/secrets/relayhost_password
```
### 2. Desplegar desde Portainer
### 2. Configurar `.env`
1. Ve a **Stacks** -> **Add stack**
2. Nombre: `mail-relay`
3. Configura el repositorio Git
4. Compose path: `mail-relay/docker-compose.yml`
5. Copia `mail-relay/stack.env` a `mail-relay/.env` y carga `mail-relay/.env`
6. Ajusta al menos:
Asegurate de tener `mail-relay/.env` configurado. Ajusta al menos:
- `MAIL_RELAY_HOSTNAME`
- `MAIL_RELAY_ALLOWED_SENDER_DOMAINS`
- `MAIL_RELAY_MASQUERADED_DOMAINS`
- `MAIL_RELAY_SMARTHOST`
- `MAIL_RELAY_SMARTHOST_USERNAME`
7. Deploy del stack
### 3. Desplegar con Docker Compose
```bash
cd mail-relay
docker compose --env-file .env up -d
```
## ⚙️ Variables importantes
@@ -134,4 +135,4 @@ docker logs -f mail-relay
Errores tipicos:
- `Relay access denied`: revisa `MAIL_RELAY_ALLOWED_SENDER_DOMAINS`
- Auth fallida con proveedor: revisa usuario/password SMTP
- Rechazo por DNS: valida SPF/DKIM/DMARC
- Rechazo por DNS: valida SPF/DKIM/DMARC