Mailman (eng. Postbote) ist eine webbasierte administrative Oberfläche für den Mailserver. Der Name kann für Mail Manager oder eben Postbote stehen :)
Mailman wurde speziell für die Administrierung des Mailservers aus dem Tutorial von Thomas Leister entwickelt:
Mailserver mit Dovecot, Postfix und MySQL unter Ubuntu 16.04 LTS
Bevor Mailman installiert werden kann muss der Mailserver bereits funktionieren und es muss mindestens eine Domain und ein Account in der Datenbank sein.
Die Installation ist im Grunde die selbe wie vom Chris auf GoRails.com. Ich habe sie übersetzt und für Mailman adaptiert, damit die komplizierte Installation nachverfolgt werden kann.
PS: Rechtschreibfehler inklusive 👇
Zunächst wird ein deploy Benutzer hinzugefügt.
sudo adduser deploy
sudo adduser deploy sudo
su deploy
Diesem Nutzer wird ein SSH Key hinzugefügt um das deployn zu automatisieren (es muss nicht jedesmal das Passwort des Benutzers eingegeben werden).
Auf dem lokalen Rechner generiert ihr euch einen neuen SSH Key (falls ihr bereits einen SSH Key habt könnt ihr diesen Schritt überspringen).
ssh-keygen -b 2048
Nun könnt ihr den SSH Key auf den Server kopieren.
ssh-copy-id deploy@SERVER_IP_ADRESSE
Mit ssh deploy@SERVER_IP_ADRESSE könnt ihr euch jetzt ohne Passwort am Server anmelden.
Info: Die Befehle werden alle als deploy Benutzer ausgeführt.
Zuerst werden Abhängigkeiten für Ruby installiert.
sudo apt-get update
sudo apt-get install git-core curl zlib1g-dev build-essential libssl-dev libreadline-dev libyaml-dev libsqlite3-dev sqlite3 libxml2-dev libxslt1-dev libcurl4-openssl-dev python-software-properties libffi-dev nodejs
Die einfachste Methode Ruby zu installieren ist mit rbenv:
cd
git clone https://github.com/rbenv/rbenv.git ~/.rbenv
echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc
echo 'eval "$(rbenv init -)"' >> ~/.bashrc
exec $SHELL
git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build
echo 'export PATH="$HOME/.rbenv/plugins/ruby-build/bin:$PATH"' >> ~/.bashrc
exec $SHELL
rbenv install 2.3.3
rbenv global 2.3.3
ruby -v
Als nächstes wird noch bundler installiert.
gem install bundler
Nun da Ruby installiert ist kann der Webserver eingerichtet werden.
Phusion hat ein eigenes APT Paket veröffentlicht indem Passenger bereits in NGINX enthalten ist. Wenn ihr NGINX bereits installiert habt, dann updated das Paket von Phusion euren NGINX automatisch.
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 561F9B9CAC40B2F7
sudo apt-get install -y apt-transport-https ca-certificates
# Add Passenger APT repository
sudo sh -c 'echo deb https://oss-binaries.phusionpassenger.com/apt/passenger xenial main > /etc/apt/sources.list.d/passenger.list'
sudo apt-get update
# Install Passenger & Nginx
sudo apt-get install -y nginx-extras passenger
In der Datei /etc/nginx/nginx.conf müssen die Konfigurationsdateien für Passenger inkludiert werden. Dazu öffnet ihr die Datei und sucht folgenden Block.
##
# Phusion Passenger config
##
# Uncomment it if you installed passenger or passenger-enterprise
##
include /etc/nginx/passenger.conf;
Bei der letzten Zeile muss das # entfernt werden.
Nun öffnet ihr /etc/nginx/passenger.conf und setzt das Verzeichnis wo sich die Ruby Installation befindet.
Die Datei sieht danach folgendermaßen aus:
passenger_root /usr/lib/ruby/vendor_ruby/phusion_passenger/locations.ini;
passenger_ruby /home/deploy/.rbenv/shims/ruby; # If you use rbenv
# passenger_ruby /usr/bin/passenger_free_ruby;
Da ihr eine eigene Domain besitzt ist es am besten wenn ihr euch bei eurem Domain Hoster (oder wo auch immer ihr DNS Einträge setzen könnt) eine eigene Subdomain für Mailman erzeugt.
Die Konfiguration sieht in NGINX dann folgendermaßen aus:
# /etc/nginx/sites-available/mailman.conf
server {
listen 80;
listen [::]:80 ipv6only=on;
server_name mailman.example.com;
passenger_enabled on;
rails_env production;
root /home/deploy/mailman/current/public;
# redirect server error pages to the static page /50x.html
error_page 500 502 503 504 /50x.html;
location = /50x.html {
root html;
}
}Info: Die Verzeichnisstruktur /home/deploy/mailman/current/public wird später erzeut.
Ersetzt example.com mit euer eigenen Domain und linkt die neue host Datei.
sudo ln -s /etc/nginx/sites-available/mailman.conf /etc/nginx/sites-enabled/mailman.conf
Eine Konfiguration für HTTPS wird später ergänzt.
sudo service nginx restart
MySQL ist bereits auf eurem Mailserver intalliert. Damit sich Ruby mit der Datenbank verbinden kann muss noch folgendes Paket installiert werden.
sudo apt-get install libmysqlclient-dev
Nun klont ihr euch das Repository von GitHub auf euren lokalen Rechner (am besten ein Unix basiertes OS).
Info: ruby und bundler muss auf dem Rechner ebenfalls installiert sein.
git clone https://github.com/flowryaan/mailman.git
Als nächstes wechselt ihr in das Verzeichnis und installiert alle Abhängigkeiten von Mailman.
cd mailman
bundle install
Nun da die Abhängigkeiten vorhanden sind, kann mit Capistrano alles vorbereitet werden.
cap install STAGES=production
Capistrano erzeugt die Datei config/deploy/production.rb. Löscht den Inhalt der Datei und fügt folgendes ein:
server 'SERVER_IP_ADRESSE', user: 'deploy', roles: %w{app db web}Ersetzt SERVER_IP_ADRESSE mit der IP des Servers.
Abschließend kann Mailman nun auf den Server deployd werden.
cap production deploy
Beim ersten Versuch wird Capistrano euch einen Fehler anzeigen:
linked file /home/deploy/mailman/shared/config/database.yml does not exist on SERVER_IP_ADRESSE
Die Datei existiert auf dem Server noch nicht und muss von Hand erzeugt werden. Nehmt euren lieblings Editor (nano, vim, emacs, ....) und erzeugt diese.
vim /home/deploy/mailman/shared/config/database.yml
Fügt folgendes in die Datei ein:
production:
adapter: mysql2
host: 127.0.0.1
database: vmail
username: vmail
password: MYSQL_DB_VMAIL_PASSWORT
pool: 5Ersetzt MYSQL_DB_VMAIL_PASSWORT mit dem Passwort vom MySQL Benutzer vmail.
Wenn ihr die Datei erzeugt habt führt cap production deploy von eurem lokalen Rechner erneut aus. Diesmal sollte der Rollout funktionieren.
Nachdem Mailman deployed wurde, muss in der /etc/profile das Secret und die Admin Email eingetragen werden.
Das Secret kann mit folgenden Kommando im Verzeichnis /home/deploy/mailman/current/ generiert werden:
RAILS_ENV=production bundle exec rake secret
# /etc/profile
export SECRET_KEY_BASE=012345567894324322432423...
export MAILMAN_ADMIN_EMAIL="[email protected]"
Danach kann der Rails- Applikation mitgeteilt werden, dass Sie sich neustarten soll:
touch /home/deploy/mailman/current/tmp/restart.txt
Mailman ist nun unter mailman.example.com erreichbar.