Dedicated Server: Installation von Mastodon
Diese Anleitung wurde mit den folgenden Produkten erstellt:
(Details können je nach Produkten verschiedener Anbieter variieren, aber die Hauptkonzepte bleiben gleich)
Einführung
Mastodon ist eine kostenlose und Open-Source-Software zum Betreiben selbstgehosteter Social-Networking-Dienste.
Es bietet Microblogging-Funktionen ähnlich dem Dienst X (ehemals Twitter), die von einer Vielzahl unabhängig betriebener Knoten, sogenannten Instanzen, angeboten werden – jede mit eigenem Verhaltenskodex, Nutzungsbedingungen, Datenschutzrichtlinien, Privatsphäre-Einstellungen und Moderationsrichtlinien.
Diese Anleitung konzentriert sich auf die Installation auf einer Debian-basierten Distro. Beispiele sind Debian und Ubuntu. Die Anleitung variiert je nach verwendetem Betriebssystem.
Systemvoraussetzungen
Wenn du eine Mastodon-Instanz auf deinem Server einrichten möchtest, musst du folgende Voraussetzungen erfüllen:
- Domain
- Linux-basierter Server
- Mailserver
Vorbereitung deines Systems
Es wird empfohlen, vorab den Passwort-Login für SSH zu deaktivieren, da die Nutzung von Passwort-Login auf Servern, die aus dem Internet erreichbar sind, ein Sicherheitsrisiko darstellt.
Das kannst du im Webinterface deines Servers unter Information -> Zugang & Sicherheit -> Passwort-Login deaktivieren einstellen.
Danach aktualisierst du deine Pakete mit folgendem Befehl:
apt update && apt upgrade -y
Als Nächstes installierst du die Abhängigkeiten von Mastodon:
# System-Repositories
apt install -y curl wget gnupg apt-transport-https lsb-release ca-certificates
# Node.JS
curl -sL https://deb.nodesource.com/setup_16.x | bash -
# PostgreSQL
wget -O /usr/share/keyrings/postgresql.asc https://www.postgresql.org/media/keys/ACCC4CF8.asc
echo "deb [signed-by=/usr/share/keyrings/postgresql.asc] http://apt.postgresql.org/pub/repos/apt $(lsb_release -cs)-pgdg main" > /etc/apt/sources.list.d/postgresql.list
Nachdem wir die Abhängigkeiten für Mastodon installiert haben, können wir die notwendigen Systempakete installieren. Das machen wir mit diesen zwei Befehlen:
apt update
apt install -y \
imagemagick ffmpeg libpq-dev libxml2-dev libxslt1-dev file git-core \
g++ libprotobuf-dev protobuf-compiler pkg-config nodejs gcc autoconf \
bison build-essential libssl-dev libyaml-dev libreadline6-dev \
zlib1g-dev libncurses5-dev libffi-dev libgdbm-dev \
nginx redis-server redis-tools postgresql postgresql-contrib \
certbot python3-certbot-nginx libidn11-dev libicu-dev libjemalloc-dev
Lass die Pakete installieren, das kann eine Weile dauern. Danach müssen wir yarn konfigurieren, einen Paketmanager für das zuvor installierte Node.JS:
corepack enable
yarn set version stable
Ruby installieren
Wir erstellen einen eigenen Benutzer, da das Verwalten der Ruby-Versionen so viel einfacher ist. Zuerst legst du einen User namens mastodon an, dessen Login deaktiviert ist. Danach wechselst du in den mastodon-User. Das machst du mit diesen Befehlen:
# Du kannst die Felder einfach leer lassen
adduser --disabled-login mastodon
su - mastodon
Jetzt installieren wir den Ruby-Manager rbenv, der das Verwalten von Ruby-Versionen deutlich erleichtert. Installiere ihn mit diesen Befehlen:
git clone https://github.com/rbenv/rbenv.git ~/.rbenv
cd ~/.rbenv && src/configure && make -C src
echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc
echo 'eval "$(rbenv init -)"' >> ~/.bashrc
exec bash
git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build
Nachdem du diese Befehle durch hast, kannst du Ruby installieren und gleichzeitig bundler mitinstallieren:
RUBY_CONFIGURE_OPTS=--with-jemalloc rbenv install 3.0.3
rbenv global 3.0.3
gem install bundler --no-document
Das kann etwas dauern, also gönn dir in der Zeit einen Tee oder Kaffee. Danach bist du fertig mit der Einrichtung und kannst mit exit wieder zum root-User wechseln.
PostgreSQL konfigurieren
Mastodon nutzt PostgreSQL als Datenbanksystem. Die Konfiguration erfolgt einfach mit:
sudo -u postgres psql
Im PostgreSQL-Prompt gibst du Folgendes ein:
CREATE USER mastodon CREATEDB;
\q
Mastodon einrichten
Wechsle jetzt nochmal in den mastodon-User:
su - mastodon
Lade die aktuellste Mastodon-Version mit git herunter, mit diesen zwei Befehlen:
git clone https://github.com/tootsuite/mastodon.git live && cd live
git checkout $(git tag -l | grep -v 'rc[0-9]*$' | sort -V | tail -n 1)
Jetzt installieren wir noch die letzten Abhängigkeiten für Ruby und Javascript:
bundle config deployment 'true'
bundle config without 'development test'
bundle install -j$(getconf _NPROCESSORS_ONLN)
yarn install --pure-lockfile
Erstelle deine Mastodon-Konfigurationsdatei mit:
RAILS_ENV=production bundle exec rake mastodon:setup
Falls die Datenbankeinrichtung fehlschlägt, logge dich bitte mit sudo -u postgres psql in Postgres ein und folge dieser Anleitung:
Danach wechselst du mit exit zurück zum root-User.
Webserver konfigurieren
Jetzt kommt der knifflige Teil: Du musst deinen Webserver konfigurieren. Erstelle zuerst einen A-Record und/oder AAAA-Record in deiner DNS, der direkt auf deinen Server zeigt. Alternativ kannst du auch den Root-Record auf deinen Server zeigen lassen.
Dann kopierst und aktivierst du die Mastodon-Webserver-Konfiguration mit diesen zwei Befehlen:
cp /home/mastodon/live/dist/nginx.conf /etc/nginx/sites-available/mastodon
ln -s /etc/nginx/sites-available/mastodon /etc/nginx/sites-enabled/mastodon
Bearbeite danach die Datei /etc/nginx/sites-available/mastodon mit einem Texteditor wie vim oder nano und ersetze example.com durch deine gewünschte Domain.
Als Nächstes musst du ein SSL-Zertifikat für deine Domain besorgen. Das geht ganz easy mit:
certbot --nginx -d <deine domain>
Gib deine Domain ein. Du wirst nach einigen Angaben gefragt. Am Ende wirst du gefragt, ob http-Anfragen automatisch auf https umgeleitet werden sollen – wir empfehlen, das zu aktivieren.
Mastodon-Service erstellen
Zum Schluss erstellen wir einen Mastodon-Systemservice. Das ist ziemlich straightforward. Kopiere die Standard-Service-Konfiguration in das Service-Verzeichnis deiner Distribution:
cp /home/mastodon/live/dist/mastodon-*.service /etc/systemd/system/
Aktiviere und starte deine neuen Services mit diesen zwei Befehlen:
systemctl daemon-reload
systemctl enable --now mastodon-web mastodon-sidekiq mastodon-streaming
Nach einem Neustart solltest du mit deiner Einrichtung fertig sein. Viel Spaß mit deiner Instanz!