Installation de Foundry VTT sous Linux

L'installation de Foundry VTT sous Linux est un must-have pour tous les maîtres qui ambitionnent d'héberger leurs parties sur un serveur à la maison ou chez un hébergeur. Pour fonctionner correctement, Foundry VTT nécessite la présence de NodeJS. Si son installation est triviale sous Windows et Mac OS, elle est moins évidente sous Linux lors d'une installation à distance en ligne de commande.

Nous allons dans un premier temps installer les dépendances nécessaires à la compilation de NodeJS, puis déployer NodeJS grâce à un gestionnaire de package appelé ASDF, et enfin, installer Foundry VTT.

La première étape consiste à installer les dépendances nécessaires à la compilation de NodeJS en fonction de votre distribution Linux. Les 2 distributions les plus courantes chez les hébergeurs sont Ubuntu & Fedora.

Sous Debian/Ubuntu

Dans le cas où vous utiliseriez une distribution Ubuntu, ouvrez votre Terminal et exécutez les commandes suivantes :

sudo apt-get update
sudo apt-get install git-core zlib1g-dev build-essential libssl-dev libreadline-dev libyaml-dev libsqlite3-dev sqlite3 libxml2-dev libxslt1-dev libcurl4-openssl-dev software-properties-common libffi-dev

Pour exécuter une commande, il suffit d'appuyer sur Entrée une fois que celle-ci a été saisie.

Sous Red Hat/Fedora

Si vous utilisez une distribution Fedora, ouvrez votre Terminal et exécutez cette commande :

sudo dnf install git-core zlib zlib-devel gcc-c++ patch readline readline-devel libyaml-devel libffi-devel openssl-devel make bzip2 autoconf automake libtool bison curl sqlite-devel perl-FindBin

Votre machine est dorénavant en mesure de compiler des sources pour permettre l'exécution de NodeJS.

Ensuite, nous allons installer NodeJS en utilisant un gestionnaire de package appelé ASDF. Le gestionnaire de package vous permet de faire évoluer vos librairies logicielles en préservant l'intégrité de votre système. Autrement dit, corrompre votre OS et devoir tout réinstaller from scratch.

L'installation du gestionnaire de package ASDF est un processus simple en deux étapes :

1. Installer ASDF
2. Ajouter ASDF à votre shell

Copier-coller les lignes de commandes qui suivent :

cd
git clone https://github.com/excid3/asdf.git ~/.asdf
echo '. "$HOME/.asdf/asdf.sh"' >> ~/.bashrc
echo '. "$HOME/.asdf/completions/asdf.bash"' >> ~/.bashrc
echo 'legacy_version_file = yes' >> ~/.asdfrc
echo 'export EDITOR="code --wait"' >> ~/.bashrc
exec $SHELL

Maintenant qu'ASDF, est installer nous allons ajouter le NodeJS au gestionnaire de package avec la ligne de commande suivante :

asdf plugin add nodejs

Pour installer NodeJS et définir la version par défaut, exécutez les commandes suivantes :

asdf install nodejs 21.0.0
asdf global nodejs 21.0.0

Au moment de l'écriture de cet article, la dernière version Foundry VTT (11.313) nécessite une version LTS de NodeJS (égale ou supérieure à 20.9.0).

Vous allez vérifier que la version par défaut de NodeJS correspond à la version que vous venez d'installer. Les informations préfixées par #=> sont les réponses qui doivent s'afficher après avoir saisi votre ligne de commande

which node
#=> /home/username/.asdf/shims/node
node -v
#=> 21.0.0

Maintenant que NodeJS fonctionne, vous allez pouvoir installer Foundry VTT en suivant les étapes décrites dans la page d'aide à l'installation.

Récupérer le lien de téléchargement de Foundry VTT

Une nouvelle fois le Terminal est votre ami que vous installiez sur votre machine ou sur un serveur chez un hébergeur.

Vous allez, tout d'abord, récupérer le lien de téléchargement sur en cliquant sur le bouton TIMED URL.

Extraction de l'archive et lancement de Foundry VTT à l'aide de NodeJS

Maintenant que le lien de l'archive est copiée, vous allez créer les dossiers qui vont contenir l'application foundryvtt et les données foundrydata :

cd $HOME
mkdir foundryvtt
mkdir foundrydata

Positionnez vous dans le dossier de l'application foundryvtt et lancez le téléchargament. Vous allez utilisez wget pour télécharger l'archive.

cd foundryvtt
wget -O foundryvtt.zip "<copier-le-lien-ici>"
unzip foundryvtt.zip

Enfin, vous allez lancer l'application depuis le dossier foundryvtt

node resources/app/main.js --dataPath=$HOME/foundrydata

Votre Terminal devrait afficher ce message :

[info] Server started and listening on port 30000

Saisir votre numéro de licence

Une fois l'application lancée, connectez vous à l'adresse de votre machinne et saisissez la clé de licence logicielle que vous avez achetée et cliquez sur Submit Key.

Foundry VTT fonctionne sur votre machine, la préparation de votre partie peut débuter.