add mailcow and debian setup
This commit is contained in:
parent
ac9be3cff5
commit
7484aed75c
2 changed files with 171 additions and 0 deletions
|
|
@ -92,6 +92,11 @@
|
||||||
"name": "Nextcloud auf Proxmox",
|
"name": "Nextcloud auf Proxmox",
|
||||||
"url": "/anleitungen/nextcloud.html",
|
"url": "/anleitungen/nextcloud.html",
|
||||||
"type": "link"
|
"type": "link"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"name": "Mailcow E-Mail Server",
|
||||||
|
"url": "/anleitungen/mailcow.html",
|
||||||
|
"type": "link"
|
||||||
}
|
}
|
||||||
]
|
]
|
||||||
},
|
},
|
||||||
|
|
|
||||||
166
public/anleitungen/mailcow.html
Normal file
166
public/anleitungen/mailcow.html
Normal file
|
|
@ -0,0 +1,166 @@
|
||||||
|
<!DOCTYPE html>
|
||||||
|
<html lang="de">
|
||||||
|
|
||||||
|
<head>
|
||||||
|
<meta charset="UTF-8">
|
||||||
|
<meta content="width=device-width, initial-scale=1.0" name="viewport">
|
||||||
|
<title></title>
|
||||||
|
<link href="/css/style.css" rel="stylesheet">
|
||||||
|
</head>
|
||||||
|
|
||||||
|
<body>
|
||||||
|
<jl-header data-title="Mailcow auf Debian installieren"></jl-header>
|
||||||
|
<div id="content">
|
||||||
|
<p>In der folgenden Anleitung werde ich darauf eingehen wie man eine VM mit Debian installiert und darauf
|
||||||
|
Mailcow.</p>
|
||||||
|
<p>
|
||||||
|
Für die Debian Installation wird zuerst ein aktuelles ISO Image benötigt. Dieses kann <a
|
||||||
|
href="https://www.debian.org/download">hier</a> heruntergeladen werden. Hierfür wird ein System mit
|
||||||
|
mindestens 2GB RAM, 2 Kernen und 10GB Storage empfohlen. Wenn die VM con der CD gebootet wird kommt als
|
||||||
|
erstes ein Auswahlmenü, in diesem die Option Install wählen und danach enter drücken.</p>
|
||||||
|
<img src="/API/getFile.php?filename=img/debian_grub.jpg">
|
||||||
|
<p>Im nächsten Schritt wird die Sprache, die Region und das Tastaturlayout fetgelegt. Im nächsten Schritt
|
||||||
|
konfiguriert Debian einige Einstellungen wie die Netzwerkkonfiguration. Wenn die automatische Konfiguration
|
||||||
|
abgeschlossen ist, frag der Installer nach dem Hostname, dieser kann frei gewählt werden. Ich verwende
|
||||||
|
hierbei gerne Namen, die zu dem System passen, wie zum Beispiel mailcow. Der Domain Name im darauffolgenden
|
||||||
|
Schritt kann leer gelassen werden. Wenn dieser festgelegt wurde sollte das Passwort für den root Benutzer
|
||||||
|
festgelegt werden. Hierbei sollte auf einen <a href="https://passwordsgenerator.net/">Passwortgenerator</a>
|
||||||
|
gesetzt werden. Nachdem das Passwort für den root Benutzer festgelegt wurde fragt Debian noch nach
|
||||||
|
benötigten Daten für einen nicht root Nutzer. Hierbei muss ein Anzeigenahme, ein Nutzername und ein <a
|
||||||
|
href="https://passwordsgenerator.net/">generiertes Passwort</a> festgelegt werden. Die Partitionierung
|
||||||
|
wird mit "Guieded - use entire disk" bestätigt, danach die Festplatte ausgewählt. Als Partitionsschema wird
|
||||||
|
"All Files in one partition" gewählt. Wenn alle Optionen gesetzt wurden wird nochmal eine zusammenfassung
|
||||||
|
angezeigt. Diese wird dann mit "Finish partitioning and write changes to disk" und danach nochmal mit "yes"
|
||||||
|
bestätigt.</p>
|
||||||
|
<img src="/API/getFile.php?filename=img/debian_partition_method.jpg">
|
||||||
|
<img src="/API/getFile.php?filename=img/debian_partition_finish.jpg">
|
||||||
|
<p>Nun wird Debian auf die Festplatte installiert. Jenachdem wie schnell das Bootlaufwerk und die Festplatte ist
|
||||||
|
kann dieser Schritt einige Minuten dauern. Nachdem die ersten Dateien auf die Festplatte kopiert wurden,
|
||||||
|
fragt Debian ob CDs mit Paketen eingelesen werden sollen. Dieser Schritt sollte mit "No" bestätigt werden.
|
||||||
|
Danach sollte die Region wo der Server steht ausgewählt werden, damit wählt Debian den nächstbesten Server
|
||||||
|
für die Paketquellen aus. Die in der Region verfügbaren Server werden in der nächsten Seite angezeigt.
|
||||||
|
Hierbei können im Prinzip alle verwendet werden außer "deb.debian.org", da diese relativ langsam sind.
|
||||||
|
Generell empfehle ich hierbei große Hoster oder UNIs. Ein Proxy im nächsten Schritt muss nicht angegeben
|
||||||
|
werden. Die Analysedaten sollten in jedem Fall abgelehnt werden, außer du willst deine Daten an Debian
|
||||||
|
weitergeben. Im nächsten Schritt sollte nur der SSH Server aktiviert werden. Die Optionen können deaktiviert
|
||||||
|
oder aktiviert werden, indem mit den Pfeiltasten auf die entsprechende Option navigiert wird und dann die
|
||||||
|
Leertaste gedrückt wird.</p>
|
||||||
|
<img src="/API/getFile.php?filename=img/debian_scan_media.jpg">
|
||||||
|
<img src="/API/getFile.php?filename=img/debian_survey.jpg">
|
||||||
|
<img src="/API/getFile.php?filename=img/debian_software.jpg">
|
||||||
|
<p>Nachdem der SSH Server installiert wurde, muss der Bootloader installiert werden, dafür muss bei der Frage ob
|
||||||
|
Grub installiert werden soll "Yes" gedrückt werdeb und in der nächsten Seite die Systemfestplatte ausgewählt
|
||||||
|
werden.</p>
|
||||||
|
<img src="/API/getFile.php?filename=img/debian_grub_install.jpg">
|
||||||
|
<p>Nachdem das System installiert wurde wird Debian neugestartet. Nun kann sich entweder über die Oberfläche
|
||||||
|
angemeldet werden oder via SSH über die IP Adresse. Nach der Authentifizierung am System mit dem zuvor
|
||||||
|
erstellten Nutzer muss sich als root angemeldet werden und danach das System auf den neuesten Stand gebracht
|
||||||
|
werden.</p>
|
||||||
|
<pre>
|
||||||
|
<code class="language-bash">su root
|
||||||
|
# nun muss das Passwort den root Benutzers eingegeben werden
|
||||||
|
apt update
|
||||||
|
apt upgrade -y</code>
|
||||||
|
</pre>
|
||||||
|
<p>Nachdem das System auf dem neuesten Stand ist kann (auch als root) Docker installiert werden. Docker stellt
|
||||||
|
hierfür ein Script bereit. Zum herunterladen des Scripts muss zuerst Curl installiert werden.</p>
|
||||||
|
<pre>
|
||||||
|
<code class="language-bash">su root #nicht benötigt falls noch als root angemeldet aus dem vorherigen Schritt.
|
||||||
|
apt install curl -y
|
||||||
|
curl -sSL https://get.docker.com/ | CHANNEL=stable sh
|
||||||
|
systemctl enable --now docker
|
||||||
|
apt install docker-compose git -y</code>
|
||||||
|
</pre>
|
||||||
|
<p>Nachdem nun die erforderlichen Vorbereitungen auf dem System abgeschlossen wurden, kann mit der Installation
|
||||||
|
vom Mailcow selber begonnen werden. Dazu muss als erstes mit Git sich die Anwendung heruntergeladen werden
|
||||||
|
und danach die Konfigurationsdatei mit dem mitgelieferten Script generiert werden. Das nachfolgende Script
|
||||||
|
muss wie auch die beiden vorherigen mit root Rechten ausgeführt werden. Das Script fragt zuerst nach dem
|
||||||
|
Hostname, welcher später verwendet werden soll um das WebUI von Mailcow zu erreichen und danach nach der
|
||||||
|
Zeitzone, für welche "Europe/Berlin" verwendet werden sollte. </p>
|
||||||
|
<pre>
|
||||||
|
<code class="language-bash">cd /opt
|
||||||
|
git clone https://github.com/mailcow/mailcow-dockerized
|
||||||
|
cd mailcow-dockerized
|
||||||
|
./generate_config.sh</code>
|
||||||
|
</pre>
|
||||||
|
<p>
|
||||||
|
Nachdem nun Mailcow zum ersten starten vorbereitet wurde, muss bevor es gestartet werden kann, die Firewall
|
||||||
|
angepasst werden. Dafür müssen die nachfolgenden Ports von außen erreichbar sein:
|
||||||
|
<ul>
|
||||||
|
<li>25: SMTP</li>
|
||||||
|
<li>465: SMTP Secure</li>
|
||||||
|
<li>585: SMTP Submission</li>
|
||||||
|
<li>143: IMAP</li>
|
||||||
|
<li>993: IMAP Secure</li>
|
||||||
|
<li>80: HTTP</li>
|
||||||
|
<li>443: HTTPS</li>
|
||||||
|
</ul>
|
||||||
|
Falls Mailcow nicht außerhalb des lokalen Netztes erreichbar sein soll (z.B. weil Mails nur über VPN abrufbar
|
||||||
|
sein sollen) reicht es Port 25 nach außen zu öffnen. Dieser wird aber zwingend benötigt, da über den SMTP Port
|
||||||
|
eingehende Mails ankommen. Nachdem die Ports freigegeben wurden, müssen noch einige DNS Einträge angelegt
|
||||||
|
werden. Der
|
||||||
|
erste ist ein A Record für den im Config Script angegebenen Hostname auf die öffentliche IP Adresse des Servers
|
||||||
|
gesetzt werden. Als zweiter Eintrag muss ein MX Eintrag auf den Domain selber gesetzt werden. Als MX Server muss
|
||||||
|
der bei Mailcow angegebene Hostname angegeben werden. Die Priorität ist bei nur einem Server uninteressant,
|
||||||
|
daher kann hier jede Zahl eingegeben werden. Bei mehreren Servern versucht der sendende Server von der kleinsten
|
||||||
|
Priorität an alle durch bis er einen erreichen kann. Als nächstes muss ein CNAME Eintrag für autodiscover und
|
||||||
|
einer autoconfig auf den Mail Domain angelegt werden.
|
||||||
|
</p>
|
||||||
|
<img src="/API/getFile.php?filename=img/mailcow_dns.jpg">
|
||||||
|
<p>
|
||||||
|
Wenn nun die beiden DNS Einträge laufen kann Mailcow das erste mal mit dem nachfolgenden Befehl gestartet
|
||||||
|
werden. Beim ersten mal werden alle Programme heruntergeladen, abhängig von der Internetgeschwindigkeit kann
|
||||||
|
dies einige Minuten dauern. Nach ein paar weiteren Minuten sollte über den festgelegten Domain das
|
||||||
|
Webinterface erreichbar sein.
|
||||||
|
</p>
|
||||||
|
<pre>
|
||||||
|
<code class="language-bash">docker-compose up</code>
|
||||||
|
</pre>
|
||||||
|
<img src="/API/getFile.php?filename=img/mailcow_login.jpg">
|
||||||
|
<p>
|
||||||
|
Nachdem das oben abgebildete Login Fenster angezeigt wird, ist Mailcow fertig gestartet. Der default
|
||||||
|
Nutzername ist admin mit dem Passwort moohoo, dieses sollte umgehend nach dem ersten Login abgeändert
|
||||||
|
werden. Dazu in der Benutzerübersicht beim Admin Benutzer auf "edit" (blauer Button im Bild unten) klicken
|
||||||
|
und ein neues Passwort mit
|
||||||
|
einem <a href="https://passwordsgenerator.net">Passwortgenerator</a> erstellen und speichern. Als nächstes
|
||||||
|
empfehle ich dringend ein Zweifaktor Login festzulegen. Dazu kann entweder wenn ein passender <a
|
||||||
|
href="https://www.amazon.de/dp/B07HBD71HL/">Hardwareschlüssel</a> vorhanden ist WebAuthn oder Yubico
|
||||||
|
verwendet werden. Wenn kein Hardwareshlüssel vorhanden ist, können time based OTP Keys verwendet werden.
|
||||||
|
Hierfür kann ich entweder die Integration im kostenpflichtigen Bitwarden Passwortmanager oder die Android
|
||||||
|
App <a href="https://play.google.com/store/apps/details?id=org.liberty.android.freeotpplus">FreeOTP+</a>
|
||||||
|
empfehlen. Im nächsten Schritt kann der Domain für die Mails angelegt werden, dafür auf die Domin
|
||||||
|
Konfiguration unter Configuration --> Mail Setup wechseln und einen neuen Domain anlegen. (siehe Screenhots)
|
||||||
|
In dem Popup muss nur der Domain angegeben werden und danach mit "Add domain and restart SOGo" angelegt
|
||||||
|
werden. Nach einem Moment warten ist der Domain in Mailcow erstellt und unter "Mailboxes" können nun
|
||||||
|
Mailboxen angelegt werden.
|
||||||
|
</p>
|
||||||
|
<img src="/API/getFile.php?filename=img/mailcow_setup_mail.jpg">
|
||||||
|
<img src="/API/getFile.php?filename=img/mailcow_domain_setup.jpg"><br>
|
||||||
|
<img src="/API/getFile.php?filename=img/mailcow_domain_new_1.jpg">
|
||||||
|
<img src="/API/getFile.php?filename=img/mailcow_domain_new_2.jpg">
|
||||||
|
<p>
|
||||||
|
In der Mailbox Konfiguration kann nun mit dem Button "Add mailbox" eine neue Mailbox angelegt werden. Hier
|
||||||
|
muss der Teil der Mail vor dem "@" angegeben werden. (Beispielswiese für die Mail info@jonasled-test.xyz
|
||||||
|
muss hier info angegeben werden) Danach sollte der volle Name des Nutzers und ein Passwort aus einem
|
||||||
|
<a href="https://passwordsgenerator.net/">Passwortgenerator</a> festgelegt werden. Wenn nun alle
|
||||||
|
Einstellungen passen, kann der Domain mit "Add" angelegt werden. Nun kann sich der Nutzer ins SOGo anmelden
|
||||||
|
um das Webmail zu nutzen oder mit einem Client wie Thunderbird anmelden.
|
||||||
|
</p>
|
||||||
|
<img src="/API/getFile.php?filename=img/mailcow_mailbox_new.jpg">
|
||||||
|
<p>
|
||||||
|
Nachdem wir nun die erste Mailbox erstellt haben, muss noch ein DNS Eintrag erstellt werden, damit andere
|
||||||
|
Server validieren können, dass der sendende Server wirklich authorisiert dazu ist. Dazu im Mailcow Admin
|
||||||
|
Interface auf Configuration --> Configuration & Details gehen und dann abschließend auf der Seite unter
|
||||||
|
Configuration auf ARC/DKIM Keys gehen. Danach den beim Domain angegebenen Key kopieren und in der DNS Verwaltung als TXT Record mit der Bezeichnung "dkim._domainkey" eintragen.
|
||||||
|
</p>
|
||||||
|
<img src="/API/getFile.php?filename=img/mailcow_dkim_webui.jpg">
|
||||||
|
<img src="/API/getFile.php?filename=img/mailcow_dkim_dns.jpg">
|
||||||
|
</div>
|
||||||
|
<jl-footer></jl-footer>
|
||||||
|
<script src="/js/script.js"></script>
|
||||||
|
<script>
|
||||||
|
document.title = "Mailcow installieren - Jonas Leder";
|
||||||
|
</script>
|
||||||
|
</body>
|
||||||
|
|
||||||
|
</html>
|
||||||
Loading…
Reference in a new issue