Foundry VTT

License: Foundry VTT is not free software, but you can host it on your own server. See FoundryVTT license

This guide is tested with Foundry VTT 14.362 on Uberspace 8.0.75. We can't guarantee it to work with newer versions.

Foundry Virtual Tabletop is a platform that enables you to play tabletop role playing games like Dungeons and Dragons or Pathfinder online.

---

Note

For this guide you should be familiar with the basic concepts of:

• Node.js
• Web Backends
• Systemd

Prerequisites

You need to purchase a license key to run your own version of Foundry.

Foundry requires the use of NodeJS 24

Installation

Create the required directories:

[isabell@moondust ~]$ mkdir ~/foundryvtt
[isabell@moondust ~]$ mkdir ~/foundrydata

Download and unpack the archive:

You will need to get your link from the Foundry VTT website, the link expires after a few minutes. Use the following command to download Foundry, replace <yourlink> with your personal link to the archive, choose the Node.js Operating System.

[isabell@moondust ~]$ cd ~/foundryvtt
[isabell@moondust foundryvtt]$ wget -O foundryvtt.zip "<yourlink>"

After the download has completed, extract the archive with the following command:

[isabell@moondust foundryvtt]$ unzip foundryvtt.zip
Archive: foundryvtt.zip

Configuration

Expose Foundry to the web. This will override the current setting for your web root (like the default Apache service).

[isabell@moondust ~]$ uberspace web backend add / port 30000 --force

Then, create a service to run Foundry permanently in the background:

[isabell@moondust ~]$ uberspace service add foundry "node foundryvtt/main.js --dataPath=foundrydata"

You can check if the Foundry service is running with:

[isabell@moondust ~]$ uberspace service list

To use your Foundry instance, point you're browser to [https://isabell.uber.space] (using your username).

Tuning

• Change the default admin password in the config tab immediately after installation.
• When you create a new world in Foundry it does not have a password by default. Keep in mind to setup a password after world creation.

Debugging

If something is wrong, check the log of your service with

[isabell@moondust ~]$ journalctl --user --unit foundry --since 'yesterday'

Updates

You can use Foundrys own update mechanism on the setup page. For major version updates you should make a backup of the foundrydata folder.