Foundry Virtual Tabletop

[LoudLemur]

Tutorial For How to Install Foundry on Cloudron

Here’s a step-by-step guide to installing FoundryVTT on Cloudron using the public image, as shown in your screenshots and the asciinema cast.

Prerequisites
You have a working Cloudron server.
You have the Cloudron CLI installed and configured.
You have git and jq installed on your system.
You have a domain/subdomain ready to use for FoundryVTT (e.g., d20.cloudron.dev).
Step-by-Step Installation

1. Clone the FoundryVTT Cloudron App Repository
   Open your terminal and run:

Bash

git clone https://github.com/BrutalBirdie/cloudron-foundryvtt.git

This will create a folder called cloudron-foundryvtt.

2. Change Directory
   Move into the cloned directory:

Bash

cd cloudron-foundryvtt

3. Get the App ID and Version
   Extract the app ID and version from the manifest using jq:

Bash

jq -r .id CloudronManifest.json
jq -r .version CloudronManifest.json

The output should be something like:

App ID: foundryvtt.cloudron.app
Version: 0.0.6 (or whatever is current)

4. Install the App Using the Public Image
   Replace d20.cloudron.dev with your desired subdomain.

Bash

cloudron install --location d20.cloudron.dev --image brutalbirdie/$(jq -r .id CloudronManifest.json):$(jq -r .version CloudronManifest.json)

This command tells Cloudron to install the app at your chosen subdomain using the public Docker image.
5. Wait for Installation to Complete
The CLI will show progress: registering subdomains, waiting for DNS propagation, etc.
Once you see App is installed., you’re done!
6. Check Logs (Optional)
To check the app logs:

Bash

cloudron logs --app d20.cloudron.dev

7. Access FoundryVTT
   Open your browser and go to https://d20.cloudron.dev (or your chosen subdomain).
   You should see the FoundryVTT setup page.
   Troubleshooting
   If you get DNS errors, make sure your subdomain is correctly set up and points to your Cloudron server.
   If you need to update or reinstall, repeat the steps above.
   References
   Cloudron FoundryVTT GitHub
   Cloudron CLI Docs
   FoundryVTT Knowledge Base
   You’re done!
   You now have FoundryVTT running on your Cloudron server. If you need to update, just pull the latest image and repeat the install command.

[msbt]

@LoudLemur for your bash snippets you should use the code formatting with either a single backtick ` for lines or tripple ones for codeblocks:

cloudron install --location d20.cloudron.dev --image brutalbirdie/$(jq -r .id CloudronManifest.json):$(jq -r .version CloudronManifest.json)

[LoudLemur]

@msbt Thanks! I updated the tutorial.

[TheMeerkat]

hey, @BrutalBirdie; could i request an update? thank you :3c

[BrutalBirdie]

HeyO @TheMeerkat
Done

https://github.com/BrutalBirdie/cloudron-foundryvtt/releases/tag/13.348

How to update was discussed multiple times

[LoudLemur]

@BrutalBirdie I still can't understand why Foundry isn't officially supported on Cloudron yet.

[TheMeerkat]

@BrutalBirdie Thank you!

[TheMeerkat]

@LoudLemur There's higher standards for official apps. Right now, it's only really updated whenever I poke BrutalBirdie for one because the PF2E app needs the latest version to work.

[BrutalBirdie]

Updated the app to version 13.351.

• GitHub: https://github.com/BrutalBirdie/cloudron-foundryvtt/releases/tag/13.351
• Dockerimage: https://hub.docker.com/repository/docker/brutalbirdie/foundryvtt.cloudron.app/tags/0.1.1/sha256:3f1c96849458265eecb4edea58532f686eb644eda1f4533b3995bd007a9e7f9a

Update:

cloudron update --app $YOUR_APP_LOCATION --image brutalbirdie/foundryvtt.cloudron.app:0.1.1

[BrutalBirdie]

Updated the app to version 14.359

version 14.359 is still very fresh. If you use a lot of community modules they will probably break.
So only update to version 14.359 if you made sure your community modules are working for the new version.

---

You can now use the CloudronVersions.json to install the FoundryVTT Community App.
If you have installed the app in the old style, you won't get automatic updates and need to update the old style way.

• pull the GitHub repo: git pull git@github.com:BrutalBirdie/cloudron-foundryvtt.git && cd cloudron-foundryvtt
• cloudron update --app $YOUR_APP_LOCATION --image brutalbirdie/foundryvtt.cloudron.app:2.0.1

The easy way to "migrate" from the old installation style to the new community app style would be:

• update manually to the latest version
• create a backup
• download the backup config
• uninstall the app
• install the app from the app store with the CloudronVersions.json
• restore your backup

Now you should get automatic app updates when I release a new version.