docs: create mxroute-mailcow
This commit is contained in:
Administrator
John Smith
parent
2df2c47f28
commit
a153c1b294
1 changed files with 271 additions and 0 deletions
271
mxroute-mailcow.md
Normal file
271
mxroute-mailcow.md
Normal file
|
|
@ -0,0 +1,271 @@
|
||||||
|
---
|
||||||
|
title: Recieving Mail thru MXRoute
|
||||||
|
description: Trusted receiver
|
||||||
|
published: true
|
||||||
|
date: 2026-02-15T01:44:15.683Z
|
||||||
|
tags:
|
||||||
|
editor: markdown
|
||||||
|
dateCreated: 2026-02-15T01:44:15.683Z
|
||||||
|
---
|
||||||
|
|
||||||
|
# MXroute Incoming Mail to Mailcow
|
||||||
|
|
||||||
|
## Overview
|
||||||
|
Configuration guide for using MXroute to receive incoming mail for your domains and forward to your Mailcow server.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Architecture
|
||||||
|
|
||||||
|
```
|
||||||
|
Internet → MXroute (receives) → Mailcow (delivers)
|
||||||
|
```
|
||||||
|
|
||||||
|
This setup allows MXroute to handle incoming mail filtering, spam protection, and then forward clean mail to your Mailcow server.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## MXroute Configuration
|
||||||
|
|
||||||
|
### 1. Add Domain to MXroute
|
||||||
|
|
||||||
|
1. Log into MXroute DirectAdmin panel
|
||||||
|
2. Navigate to **Email Accounts** → **Email Domains**
|
||||||
|
3. Add your domain (e.g., `yourdomain.com`)
|
||||||
|
|
||||||
|
### 2. Create Forwarder Accounts
|
||||||
|
|
||||||
|
For each mailbox you want to receive mail:
|
||||||
|
|
||||||
|
1. Navigate to **Email Accounts** → **Forwarders**
|
||||||
|
2. Create forwarder:
|
||||||
|
- **Email Address:** user@yourdomain.com
|
||||||
|
- **Forward To:** user@mail.yourdomain.com (your Mailcow server)
|
||||||
|
3. Enable **Discard if no forwarders exist** (optional, prevents bounces)
|
||||||
|
|
||||||
|
**Alternative: Catch-all Forwarder**
|
||||||
|
- Create a catch-all forwarder: `*@yourdomain.com` → `@mail.yourdomain.com`
|
||||||
|
- This forwards all mail to Mailcow regardless of recipient
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## DNS Configuration
|
||||||
|
|
||||||
|
### Update MX Records
|
||||||
|
|
||||||
|
Point your domain's MX records to MXroute servers:
|
||||||
|
|
||||||
|
```
|
||||||
|
yourdomain.com → MX 10 arrow.mxroute.com
|
||||||
|
yourdomain.com → MX 20 eagle.mxroute.com
|
||||||
|
```
|
||||||
|
|
||||||
|
**Note:** Check your MXroute account for the correct server hostnames (arrow, eagle, hermes, etc.)
|
||||||
|
|
||||||
|
### SPF Record
|
||||||
|
|
||||||
|
Update SPF to allow MXroute to send on your behalf:
|
||||||
|
|
||||||
|
```
|
||||||
|
v=spf1 include:mxroute.com -all
|
||||||
|
```
|
||||||
|
|
||||||
|
If you also send from Mailcow directly:
|
||||||
|
```
|
||||||
|
v=spf1 ip4:192.168.5.16 include:mxroute.com -all
|
||||||
|
```
|
||||||
|
|
||||||
|
### DKIM Records
|
||||||
|
|
||||||
|
1. Generate DKIM key in MXroute DirectAdmin:
|
||||||
|
- Navigate to **Email Authentication** → **DKIM Keys**
|
||||||
|
- Generate key for your domain
|
||||||
|
- Copy the DNS record
|
||||||
|
|
||||||
|
2. Add DKIM TXT record to your DNS:
|
||||||
|
```
|
||||||
|
default._domainkey.yourdomain.com → [MXroute DKIM public key]
|
||||||
|
```
|
||||||
|
|
||||||
|
### DMARC Record
|
||||||
|
|
||||||
|
```
|
||||||
|
_dmarc.yourdomain.com → v=DMARC1; p=quarantine; rua=mailto:admin@yourdomain.com
|
||||||
|
```
|
||||||
|
|
||||||
|
**Note:** Start with `p=quarantine` for testing, then move to `p=reject` once confirmed working.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Mailcow Configuration
|
||||||
|
|
||||||
|
### 1. Allow MXroute IP Addresses
|
||||||
|
|
||||||
|
Add MXroute server IPs to Mailcow's trusted networks:
|
||||||
|
|
||||||
|
1. SSH into your Mailcow server
|
||||||
|
2. Edit `mailcow.conf`:
|
||||||
|
```bash
|
||||||
|
nano /opt/mailcow-dockerized/mailcow.conf
|
||||||
|
```
|
||||||
|
|
||||||
|
3. Add MXroute IPs to `SKIP_CLAMD` or trusted networks
|
||||||
|
4. Restart Mailcow:
|
||||||
|
```bash
|
||||||
|
docker-compose down
|
||||||
|
docker-compose up -d
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2. Configure Mailboxes
|
||||||
|
|
||||||
|
Create mailboxes in Mailcow for each user:
|
||||||
|
|
||||||
|
1. Navigate to Mailcow admin → **Mailboxes**
|
||||||
|
2. Create mailbox: `user@yourdomain.com`
|
||||||
|
3. Set password and quota
|
||||||
|
|
||||||
|
### 3. Disable Greylisting (Optional)
|
||||||
|
|
||||||
|
If you experience delays:
|
||||||
|
|
||||||
|
1. Navigate to **Configuration** → **Configuration & Details**
|
||||||
|
2. Find your domain
|
||||||
|
3. Disable greylisting for MXroute IPs
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Testing
|
||||||
|
|
||||||
|
### 1. Test Mail Flow
|
||||||
|
|
||||||
|
Send test email from external provider (Gmail, Outlook):
|
||||||
|
```
|
||||||
|
From: test@gmail.com
|
||||||
|
To: user@yourdomain.com
|
||||||
|
```
|
||||||
|
|
||||||
|
**Expected Flow:**
|
||||||
|
1. Mail arrives at MXroute
|
||||||
|
2. MXroute forwards to Mailcow
|
||||||
|
3. Mail appears in Mailcow inbox
|
||||||
|
|
||||||
|
### 2. Check Headers
|
||||||
|
|
||||||
|
Review email headers in Mailcow to verify:
|
||||||
|
- `Received:` headers show MXroute server
|
||||||
|
- SPF, DKIM, DMARC all pass
|
||||||
|
- No spam flags
|
||||||
|
|
||||||
|
### 3. Monitor Logs
|
||||||
|
|
||||||
|
**MXroute Logs:**
|
||||||
|
- Check DirectAdmin → Email Logs
|
||||||
|
- Verify forwarding is occurring
|
||||||
|
|
||||||
|
**Mailcow Logs:**
|
||||||
|
```bash
|
||||||
|
docker-compose logs -f postfix-mailcow
|
||||||
|
```
|
||||||
|
|
||||||
|
Look for incoming connections from MXroute IPs.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Example Configuration: gnarlypandaproductions.com
|
||||||
|
|
||||||
|
### MXroute Forwarders
|
||||||
|
| MXroute Address | Forwards To |
|
||||||
|
|-----------------|-------------|
|
||||||
|
| admin@gnarlypandaproductions.com | admin@mail.gnarlypandaproductions.com |
|
||||||
|
| contact@gnarlypandaproductions.com | contact@mail.gnarlypandaproductions.com |
|
||||||
|
| *@gnarlypandaproductions.com | @mail.gnarlypandaproductions.com |
|
||||||
|
|
||||||
|
### DNS Records
|
||||||
|
| Record Type | Name | Value |
|
||||||
|
|-------------|------|-------|
|
||||||
|
| MX | @ | 10 arrow.mxroute.com |
|
||||||
|
| MX | @ | 20 eagle.mxroute.com |
|
||||||
|
| A | mail | 192.168.5.16 |
|
||||||
|
| TXT | @ | v=spf1 ip4:192.168.5.16 include:mxroute.com -all |
|
||||||
|
| TXT | _dmarc | v=DMARC1; p=reject; rua=mailto:admin@gnarlypandaproductions.com |
|
||||||
|
| TXT | default._domainkey | [MXroute DKIM key] |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Troubleshooting
|
||||||
|
|
||||||
|
### Mail Not Being Forwarded
|
||||||
|
|
||||||
|
1. **Check MXroute forwarder configuration**
|
||||||
|
- Verify forwarder exists in DirectAdmin
|
||||||
|
- Check destination address is correct
|
||||||
|
- Review MXroute email logs
|
||||||
|
|
||||||
|
2. **Verify DNS propagation**
|
||||||
|
```bash
|
||||||
|
dig MX yourdomain.com
|
||||||
|
dig TXT yourdomain.com
|
||||||
|
```
|
||||||
|
|
||||||
|
3. **Check Mailcow firewall**
|
||||||
|
- Ensure port 25 is open
|
||||||
|
- Verify MXroute IPs aren't blocked
|
||||||
|
|
||||||
|
### SPF/DKIM Failures
|
||||||
|
|
||||||
|
1. **SPF not passing**
|
||||||
|
- Verify `include:mxroute.com` in SPF record
|
||||||
|
- Check for typos in SPF syntax
|
||||||
|
- Use SPF checker: https://mxtoolbox.com/spf.aspx
|
||||||
|
|
||||||
|
2. **DKIM not passing**
|
||||||
|
- Confirm DKIM record published in DNS
|
||||||
|
- Verify selector matches (usually `default`)
|
||||||
|
- Check DKIM record format (no spaces in key)
|
||||||
|
|
||||||
|
### Mail Delayed or Bouncing
|
||||||
|
|
||||||
|
1. **Greylisting delays**
|
||||||
|
- Disable greylisting in Mailcow for MXroute IPs
|
||||||
|
- Or wait 5-15 minutes for retry
|
||||||
|
|
||||||
|
2. **Mailbox full**
|
||||||
|
- Check quota in Mailcow
|
||||||
|
- Increase quota or clean mailbox
|
||||||
|
|
||||||
|
3. **Spam filtering**
|
||||||
|
- Check Mailcow spam folder
|
||||||
|
- Whitelist MXroute IPs in Rspamd
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## MXroute Server Information
|
||||||
|
|
||||||
|
### Common MXroute Mail Servers
|
||||||
|
- arrow.mxroute.com
|
||||||
|
- eagle.mxroute.com
|
||||||
|
- hermes.mxroute.com
|
||||||
|
- zen.mxroute.com
|
||||||
|
|
||||||
|
**Your assigned server:** Check MXroute DirectAdmin welcome email or DNS settings
|
||||||
|
|
||||||
|
### MXroute IP Ranges
|
||||||
|
Consult MXroute documentation for current IP ranges to whitelist in Mailcow.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Advantages of This Setup
|
||||||
|
|
||||||
|
- **Spam filtering:** MXroute handles initial spam filtering
|
||||||
|
- **DDoS protection:** MXroute absorbs mail-based attacks
|
||||||
|
- **Reliability:** If Mailcow is down, mail queues at MXroute
|
||||||
|
- **Deliverability:** MXroute IPs have good reputation
|
||||||
|
- **Offload processing:** Reduces load on your Mailcow server
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## References
|
||||||
|
|
||||||
|
- [MXroute Documentation](https://mxroutedocs.com/)
|
||||||
|
- [Mailcow Documentation](https://docs.mailcow.email/)
|
||||||
|
- [Email Forwarding Best Practices](https://www.rfc-editor.org/rfc/rfc5321)
|
||||||
Loading…
Add table
Add a link
Reference in a new issue