Passer au contenu principal

VPS : 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 faire tourner des services de réseaux sociaux auto-hébergés.

Il propose des fonctionnalités de microblogging similaires à celles du service X (anciennement Twitter), offertes par un grand nombre de nœuds indépendants, appelés instances,
chacune avec son propre code de conduite, conditions d’utilisation, politique de confidentialité, options de confidentialité et règles 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 installer une instance Mastodon sur ton serveur, tu dois remplir quelques prérequis :

  • Domaine
  • Serveur Linux
  • Serveur mail

Préparation de ton système

Il est recommandé de désactiver la connexion par mot de passe sur SSH avant toute chose, 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 web 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, installe 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 de 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, configure yarn, le 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 dédié, ça facilite la gestion des versions de Ruby. Commence par créer un utilisateur appelé mastodon, avec la connexion désactivée. Ensuite, passe sur cet utilisateur avec :

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

Maintenant, installe le gestionnaire Ruby rbenv, qui simplifie la gestion des versions Ruby :

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 ça fait, installe Ruby et bundler avec :

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, alors profite-en pour te prendre un thé ou un café. Une fois fini, tu peux revenir à l’utilisateur root avec la commande exit.

Configuration de PostgreSQL

Mastodon utilise PostgreSQL comme base de données. Configure-la facilement avec :

sudo -u postgres psql

Dans le prompt PostgreSQL, tape :

CREATE USER mastodon CREATEDB;
\q

Mise en place de Mastodon

Reviens sur l’utilisateur mastodon :

su - mastodon

Télécharge la dernière version de Mastodon avec git :

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, installe les dernières dépendances Ruby et Javascript :

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

Crée 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 doc :

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

Ensuite, reviens à l’utilisateur root avec exit.

Configuration du serveur web

Là, ça devient un peu plus technique. Commence par créer un enregistrement A et/ou AAAA dans ta zone DNS qui pointe directement vers ton serveur. Sinon, tu peux aussi pointer l’enregistrement racine vers ton serveur.

Ensuite, copie et active la config web de Mastodon avec ces 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

Édite ensuite le fichier /etc/nginx/sites-available/mastodon avec un éditeur comme vim ou nano et remplace example.com par ton domaine.
Puis, récupère un certificat SSL pour ton domaine facilement avec :

certbot --nginx -d <ton domaine>

Entre ton domaine. On te demandera plusieurs infos. À la fin, il te proposera de rediriger automatiquement les requêtes http vers https, on te conseille d’accepter.

Création du service Mastodon

Enfin, crée un service système pour Mastodon. C’est assez simple. Copie la config par défaut dans le dossier des services de ta distribution :

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

Active et démarre tes nouveaux services avec :

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

Conclusion

Félicitations, tu as installé et configuré Mastodon avec succès ! Si tu as d’autres questions ou soucis, contacte notre support, dispo tous les jours pour t’aider !