Mailcow op CloudPanel — Installatiehandleiding

VPS voorbereiden

Begin met een schone, ondersteunde Linux VPS.

💾 ResourcesControleer vooraf RAM, swap en opslag volgens de actuele mailcow-documentatie.

🌐 HostnameGebruik bijvoorbeeld mail.jouwdomein.nl.

🔒 PoortenZorg dat de benodigde mail- en webpoorten niet door je firewall worden geblokkeerd.

⚠️ Geen andere mailserverPostfix/Exim of een andere maildienst mag niet met mailcow concurreren.

Belangrijk: mailcow draait in Docker. Gebruik bij voorkeur een volledige VM/VPS, geen LXC/OpenVZ-container. Controleer ook altijd de actuele mailcow prerequisites.

Docker installeren

Op Debian/Ubuntu kun je Docker via de officiële methode installeren.

apt update
apt install -y git openssl curl gawk coreutils grep jq

curl -sSL https://get.docker.com/ | CHANNEL=stable sh
systemctl enable --now docker

apt install -y docker-compose-plugin

docker --version
docker compose version

Gebruik bij voorkeur een recente Docker Engine en Docker Compose 2.x. De actuele mailcow-documentatie noemt Docker >= 24 en Compose >= 2.0.

Mailcow downloaden

We plaatsen mailcow onder /opt.

cd /opt
git clone https://github.com/mailcow/mailcow-dockerized
cd mailcow-dockerized

./generate_config.sh

🐄 Wat gebeurt hier?

De configuraties worden gegenereerd en daarna kun je mailcow.conf aanpassen. Tijdens generate_config.sh geef je onder andere de hostname van je mailserver en de tijdzone op.

Mailcow configureren

Open de configuratie en pas hem aan voor CloudPanel.

cd /opt/mailcow-dockerized
nano mailcow.conf

🔀 Reverse proxy-poorten

Omdat CloudPanel/NGINX de webkant kan afhandelen, bind je de mailcow-webpoorten lokaal. Voorbeeld:

HTTP_BIND=127.0.0.1
HTTP_PORT=7080

HTTPS_BIND=127.0.0.1
HTTPS_PORT=7443

Let op: gebruik geen willekeurige poort uit voorbeelden van oude handleidingen. De actuele mailcow reverse-proxy documentatie waarschuwt expliciet tegen 8081, 9081 en 65510.

CloudPanel als reverse proxy

CloudPanel ontvangt HTTPS en stuurt de webverzoeken door naar mailcow.

🌍
Internet

→

☁️
CloudPanel / NGINX

→

🐳
Mailcow

In CloudPanel

Ga naar Sites.
Maak een Reverse Proxy voor je maildomein.
Gebruik bijvoorbeeld https://127.0.0.1:7443 als backend wanneer je mailcow op HTTPS bindt.
Configureer SSL/TLS voor je domein in CloudPanel.

De exacte CloudPanel-velden kunnen per CloudPanel-versie verschillen. CloudPanel biedt een Reverse Proxy-site en een Vhost Editor voor NGINX.

DNS instellen

Een goede DNS-configuratie is essentieel voor mailaflevering.

Type	Naam	Voorbeeld	Doel
A	mail	mail.jouwdomein.nl → VPS-IP	Mailserver bereikbaar maken
MX	@	mail.jouwdomein.nl	Inkomende mail
TXT	@	SPF-record	SPF
TXT	_dmarc	DMARC-record	DMARC
PTR	VPS-IP	mail.jouwdomein.nl	Reverse DNS
TXT	DKIM	Door mailcow gegenereerd	DKIM

Tip: stel de PTR/reverse DNS in bij je VPS-provider. Het record moet normaal naar dezelfde mailhostname wijzen die je gebruikt.

Mailcow starten

Nu kunnen de Docker-images worden gedownload en gestart.

cd /opt/mailcow-dockerized

docker compose pull
docker compose up -d

docker compose ps

Gelukt? Als de containers draaien, kun je de webinterface openen via je mailhostname.

Controle & eerste mailbox

Loop deze checklist rustig af.

DNS A-record verwijst naar de VPS. MX-record verwijst naar de mailhostname. PTR/reverse DNS is ingesteld. SPF, DKIM en DMARC zijn ingesteld. Mailcow containers zijn actief. CloudPanel reverse proxy werkt. HTTPS-certificaat is geldig. Je hebt het standaard admin-wachtwoord direct gewijzigd.

Beveiliging: gebruik nooit een standaard wachtwoord in productie. Controleer ook je firewall, updates, backups en mailcow-documentatie voordat je de server live gebruikt.

🎉 Klaar!

Je hebt nu een basisroute van een lege VPS naar mailcow achter CloudPanel. Voor productie zijn vooral DNS, PTR, firewall, TLS, spam/reputatie en backups belangrijk.

Deze handleiding is gebaseerd op de actuele officiële mailcow- en CloudPanel-documentatie; controleer die documentatie opnieuw bij toekomstige updates.