raspbbery pi Как поднять Foundry VTT на Raspbbery Pi

[guvatara]

Материал основан на статье https://foundryvtt.wiki/en/setup/linux-installation и собственном опыте.

Потребуется:

• Raspberry Pi 4 или 5 минимум с 4 Гб памяти оперативной (можно и с 2Гб, но будет очень больно местами)
• Карта памяти от 128 Гб
• Сторонний компьютер с терминалом

Данная инструкция подойдет и для сервера Ubuntu не ниже 22.04 версии, но у нас это будет Raspberry Pi OS 64bit.

Накатите на свою малинку систему с нуля. Бывает, что просто обновиться недостаточно. Запомните откройте ssh порт на устройстве. Включите малинку и ждите когда она полностью загрузится.

Далее запустите удаленный терминал с другого компьютера. Я к примеру использую PuTTY.

И залогиньтесь на Raspberry Pi

Удостоверьтесь, что ваш экран выглядит как то так как указано выше.

<user>@<servername>:_

Если там вместо <user> написан root или любой другой рутовый пользователь, то нужно создать другого пользователя. Если не рутовый, то можно сразу переходить к настройке окружения.

Создаем нового пользователя. Я например создал пользователя с именем foundry чтобы понимать для чего он служит.

sudo adduser foundry

Накинем прав созданному пользователю.

usermod -aG sudo foundry

Дальнейшие манипуляции будем проводить от имени нового пользователя.

su - foundry

Настройка системы

Нам нужны:

• NodeJs версии не ниже 20 - этого требует Foundry VTT
• caddy - для веб сервера и проксирования
• pm2 - это процесс менеджер позволит нам запустить Foundry как сервис и будет поддерживать его рабочим 24/7
• unzip - чтобы распаковать архив с Foundry
• nano - для редактирования конфигов

Как всегда, прежде чем что то делать в Raspberry Pi, его нужно обновить.

sudo apt update
sudo apt upgrade -y

Обычно это занимает от 2 до 5 минут.

Далее нужно добавить репозиторий nodejs 20 в систему.

sudo apt install -y ca-certificates curl gnupg
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://deb.nodesource.com/gpgkey/nodesource-repo.gpg.key | sudo gpg --dearmor -o /etc/apt/keyrings/nodesource.gpg
echo "deb [signed-by=/etc/apt/keyrings/nodesource.gpg] https://deb.nodesource.com/node_20.x nodistro main" | sudo tee /etc/apt/sources.list.d/nodesource.list

Добавляем репозиторий caddy в систему

sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | sudo tee /etc/apt/sources.list.d/caddy-stable.list

Устанавливаем nodejs, caddy, unzip, nano

sudo apt update
sudo apt install nodejs caddy unzip nano -y

Проверяем что nodejs и npm установились и они правильных версий.

node --version
npm --version

Версия Node должна быть 20 или выше.

Устанавливаем pm2

sudo npm install pm2 -g

Добавьте pm2 в автозагрузку.

pm2 startup

В ответе вам выдадут команду, чтобы включить автозагрузку pm2. Скопируйте ее и вставьте.

Установка Foundry VTT

Залогиньтесь на сайте  FoundrVTT и перейдите в раздел Purchased Licenses

Там нужно выбрать версию Linux/NodeJS в выборе пакета. Кликнуть на кнопку Timed URL

В буфер обмена скопируется ссылка на пакет с Foundry

Выполните следующие команды 

mkdir ~/foundry
wget --output-document ~/foundry/foundryvtt.zip "<download url>"

Где вместо <download url>    будет стоять ваша ссылка

Как только все скачается, распакуйте Foundry и удалите архив.

unzip ~/foundry/foundryvtt.zip -d ~/foundry/
rm ~/foundry/foundryvtt.zip

Если появилась ошибка, то проверьте, что скачали именно версию Linux/NodeJS

Создайте папку пользователя, где будут храниться ваши материалы.

mkdir -p ~/foundryuserdata

Проверьте, что Foundry запускается

cd ~
node foundry/resources/app/main.js --dataPath=/home/<user>/foundryuserdata

Замените <user> на имя вашего пользователя.

У вас должно появится, что то типа этого

Протестируйте что сервер доступен в браузере. Перейдите на адрес  http://<IP address>:30000 где  <IP address> это адрес вашего устройства.

Вы должны увидеть стартовый экран Foundry.

Потушите процесс в терминале нажав ctrl+C.

Теперь нужно внести Foundry в список процессов менеджера pm2.

pm2 start --name foundry /home/<user>/foundry/resources/app/main.js -- --dataPath=/home/<user>/foundryuserdata

Где вместо <user> должно быть указано от какого пользователя будет запускаться Foundry.

 Проверим, что процесс действительно запущен.

pm2 list

Сохраним конфигурацию.

pm2 save