Passer au contenu principal

Serveur dédié : Installation de Mastodon

Ce guide a été créé avec les produits suivants :

(Les détails peuvent varier selon les produits de différents fournisseurs, mais les concepts principaux restent les mêmes)

Introduction

Mastodon est un logiciel libre et open-source pour gérer des services de réseaux sociaux auto-hébergés.

Il propose des fonctionnalités de microblogging similaires au service X (anciennement Twitter), offertes par un grand nombre de nœuds indépendants, appelés instances,
chacun avec son propre code de conduite, conditions d’utilisation, politique de confidentialité, options de confidentialité et politiques de modération.

info

Ce guide se concentre sur l’installation sur une distribution basée sur Debian. Exemples : Debian et Ubuntu. Ce guide varie selon le système d’exploitation utilisé.

Prérequis système

Si tu veux configurer une instance Mastodon sur ton serveur, tu dois remplir certains prérequis :

  • Domaine
  • Serveur Linux
  • Serveur mail

Préparation de ton système

Il est recommandé de désactiver au préalable la connexion par mot de passe sur SSH, car c’est un risque de sécurité d’utiliser la connexion par mot de passe sur des serveurs accessibles depuis Internet.
Tu peux faire ça dans le panneau de contrôle de ton serveur sous Informations -> Accès & Sécurité -> Désactiver la connexion par mot de passe

Ensuite, mets à jour tes paquets avec la commande suivante :

apt update && apt upgrade -y

Ensuite, il faut installer les dépendances de Mastodon :

# Dépôts système
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

Après avoir installé les dépendances pour Mastodon, on peut installer les paquets système nécessaires. On fait ça avec ces deux commandes :

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

Laisse les paquets s’installer, ça peut prendre un peu de temps. Ensuite, il faut configurer yarn, qui est un gestionnaire de paquets pour Node.JS installé précédemment :

corepack enable
yarn set version stable

Installation de Ruby

On va créer un utilisateur différent, ça facilite la gestion des versions de Ruby. Commence par créer un utilisateur appelé mastodon, dont la connexion est désactivée. Ensuite, passe dans l’utilisateur mastodon avec ces commandes :

# Tu peux laisser les champs vides
adduser --disabled-login mastodon
su - mastodon

Maintenant, on installe le gestionnaire Ruby rbenv, qui simplifie la gestion des versions Ruby. Installe-le avec ces commandes :

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

Une fois cette série de commandes terminée, installe Ruby avec la commande suivante. On installera aussi bundler à cette étape :

RUBY_CONFIGURE_OPTS=--with-jemalloc rbenv install 3.0.3
rbenv global 3.0.3
gem install bundler --no-document

Ça peut prendre un moment, sois patient et profite-en pour prendre un thé ou un café. Une fois fini, on peut revenir à l’utilisateur root avec la commande exit.

Configuration de PostgreSQL

Mastodon utilise PostgreSQL comme système de base de données. La configuration se fait facilement avec :

sudo -u postgres psql

Dans l’invite PostgreSQL, entre ceci :

CREATE USER mastodon CREATEDB;
\q

Mise en place de Mastodon

Il faut maintenant repasser à l’utilisateur mastodon :

su - mastodon

On utilise git pour télécharger la version la plus récente de Mastodon avec ces deux commandes :

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)

Ensuite, on installe les dernières dépendances Ruby et Javascript avec ces commandes :

bundle config deployment 'true'
bundle config without 'development test'
bundle install -j$(getconf _NPROCESSORS_ONLN)
yarn install --pure-lockfile

Crée ensuite ton fichier de configuration Mastodon avec :

RAILS_ENV=production bundle exec rake mastodon:setup
info

Si la configuration de ta base de données échoue, connecte-toi à postgres avec sudo -u postgres psql et suis cette documentation :

https://gist.github.com/amolkhanorkar/8706915

Ensuite, repasse à l’utilisateur root avec la commande exit.

Configuration du serveur web

Voici la partie un peu plus délicate. Tu dois configurer ton serveur web. Commence par créer un enregistrement A et/ou AAAA dans ta zone DNS qui pointe directement vers ton serveur. Tu peux aussi pointer l’enregistrement racine vers ton serveur.

Ensuite, copie et active la configuration web de Mastodon avec ces deux commandes :

cp /home/mastodon/live/dist/nginx.conf /etc/nginx/sites-available/mastodon
ln -s /etc/nginx/sites-available/mastodon /etc/nginx/sites-enabled/mastodon

Puis édite le fichier /etc/nginx/sites-available/mastodon avec un éditeur de texte comme vim ou nano et remplace example.com par ton domaine.
Ensuite, il faut obtenir un certificat SSL pour ton domaine. Tu peux facilement le faire avec cette commande :

certbot --nginx -d <ton domaine>

Entre ton domaine. On te demandera plusieurs informations. À la fin, il te sera proposé de rediriger automatiquement les requêtes http vers https, on te recommande d’accepter.

Création d’un service Mastodon

Enfin, on crée un service système Mastodon. C’est assez simple.
Copie la configuration de service par défaut dans le répertoire des services de ta distribution avec :

cp /home/mastodon/live/dist/mastodon-*.service /etc/systemd/system/

Active et démarre tes nouveaux services avec ces deux commandes :

systemctl daemon-reload
systemctl enable --now mastodon-web mastodon-sidekiq mastodon-streaming

Après un redémarrage, ton installation devrait être terminée. Amuse-toi bien avec ton instance !