Foundry VTT pt. 1
Posted on Tue 22 August 2023 in foundry
I have no idea about how many parts there will be on installing and configuring Foundry VTT, but this is the first.
By trade, I am an infrastructure engineer/architect, and I like DIY. I have loads of stuff in my home lab.
One of the reasons I chose Foundry VTT is because it runs on Linux as well.
Did I already mention I am a Linux person? I use Fedora as my daily driver and I use RHEL based and Debian based distributions for my backends (No, not Ubuntu). Depends on what I need.
Besides Linux, I like containerization. It offers so much advantages over having stateful servers which become harder and harder to maintain over time due to configuration drift. So I am currently experimenting a lot with Podman as an alternative to Docker. Not that I do not like Docker. I just like to tinker. And OKD or Minikube is a bit too overkill for my needs (and my hardware).
It turns out there are docker images for Foundry VTT. From the list, I chose Felddy's Foundry VTT Image, because it seemed well maintained and didn't require other stuff I didn't really need like traefik, portainer, etc...
felddy also has a good description and documentation on how to deploy it, but here's the gist on how to do it with podman without root (the user is podman). Maybe I should be writing up an article on how to install and configure podman...
1. Create a secret
$ cat <<EOF | podman secret create foundryvtt_config_json -
> {
> "foundry_admin_key": "foobar",
> "foundry_password": "mysupersecretpassword,
> "foundry_username": "myusername"
> }
> EOF
Notice I use an additional space before cat so it doesn't end up in my history (HISTCONTROL)
1. Create the pod
$ podman pod create --name foundryvtt_pod --publish 30000:30000
$ podman pod start foundryvtt_pod
3. Create the container
I try to adhere as much as possible to FHS, hence I store my data on /srv/data/foundryvtt
$ podman container create --pod foundryvtt_pod \
--name foundryvtt \
--volume /srv/data/foundryvtt:/data \
--secret foundryvtt_config_json,target=config.json \
docker.io/felddy/foundryvtt:release
$ podman container start foundryvtt
And then we wait:
$ podman logs --follow foundryvtt
Entrypoint | 2023-08-22 14:38:28 | [info] Starting felddy/foundryvtt container v11.307.0
Entrypoint | 2023-08-22 14:38:28 | [info] Reading configured secrets from: /run/secrets/config.json
Entrypoint | 2023-08-22 14:38:28 | [info] No Foundry Virtual Tabletop installation detected.
Entrypoint | 2023-08-22 14:38:28 | [info] Using FOUNDRY_USERNAME and FOUNDRY_PASSWORD to authenticate.
Authenticate | 2023-08-22 14:38:29 | [info] Requesting CSRF tokens from https://foundryvtt.com
Authenticate | 2023-08-22 14:38:30 | [info] Logging in as: xxxxx
Authenticate | 2023-08-22 14:38:31 | [info] Successfully logged in as: xxxxx
Entrypoint | 2023-08-22 14:38:31 | [info] Using authenticated credentials to download release.
ReleaseURL | 2023-08-22 14:38:31 | [info] Fetching S3 pre-signed release URL for build 307...
Entrypoint | 2023-08-22 14:38:32 | [info] Using CONTAINER_CACHE: /data/container_cache
Entrypoint | 2023-08-22 14:38:32 | [info] Downloading Foundry Virtual Tabletop release.
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
0 0 0 0 0 0 0 0 --:--:-- --:--:-- --:--:-- 0
...
100 207M 100 207M 0 0 12.9M 0 0:00:16 0:00:16 --:--:-- 14.4M
Entrypoint | 2023-08-22 14:38:48 | [info] Installing Foundry Virtual Tabletop 11.307
Entrypoint | 2023-08-22 14:38:51 | [info] Preserving release archive file in cache.
Entrypoint | 2023-08-22 14:38:51 | [info] Installation not yet licensed.
Entrypoint | 2023-08-22 14:38:51 | [info] Attempting to fetch license key from authenticated account.
License | 2023-08-22 14:38:51 | [info] Fetching licenses.
License | 2023-08-22 14:38:52 | [info] Found 1 license key associated with account bushvin
Entrypoint | 2023-08-22 14:38:52 | [info] Setting data directory permissions.
Entrypoint | 2023-08-22 14:38:52 | [info] Starting launcher with uid:gid as foundry:foundry.
Launcher | 2023-08-22 14:38:52 | [info] Generating options.json file.
Launcher | 2023-08-22 14:38:52 | [info] Setting 'Admin Access Key'.
Launcher | 2023-08-22 14:38:52 | [info] Starting Foundry Virtual Tabletop.
FoundryVTT | 2023-08-22 14:38:53 | [info] Running on Node.js - Version 18.17.0
FoundryVTT | 2023-08-22 14:38:53 | [info] Foundry Virtual Tabletop - Version 11 Build 307
FoundryVTT | 2023-08-22 14:38:53 | [info] User Data Directory - "/data"
FoundryVTT | 2023-08-22 14:38:53 | [info] Application Options:
{
"awsConfig": null,
"compressSocket": false,
"compressStatic": false,
"fullscreen": false,
"hostname": null,
"hotReload": false,
"language": "en.core",
"localHostname": null,
"passwordSalt": null,
"port": 30000,
"protocol": null,
"proxyPort": null,
"proxySSL": false,
"routePrefix": null,
"sslCert": null,
"sslKey": null,
"updateChannel": "stable",
"upnp": false,
"upnpLeaseDuration": null,
"world": null,
"adminPassword": "••••••••••••••••",
"cssTheme": "foundry",
"deleteNEDB": false,
"serviceConfig": null
}
FoundryVTT | 2023-08-22 14:38:53 | [warn] Software license requires signature.
FoundryVTT | 2023-08-22 14:38:53 | [info] Server started and listening on port 30000
FoundryVTT | 2023-08-22 14:39:01 | [info] Created client session ebf0e134cd43643e29799d48
Now you should be able to fire up your browser specifying the port...
To be continued...