knownframe
Self-hosting tool Early

Foundry VTT in its own Proxmox container.

An installer and updater for Foundry Virtual Tabletop in a Proxmox VE container, run from your host’s shell with the copy that comes with your own license.

Early and lightly tested, so far on Foundry VTT 14 and Proxmox VE 9, so back up before you point it at a server you care about.

  • Free and open source
  • MIT
  • Proxmox VE
  • Requires a Foundry VTT license

Star

What foundry-ops helps with

One command on your host

Creates a Debian 13 container (2 cores, 4 GB RAM and 20 GB disk unless you choose otherwise) and installs Foundry VTT in it. Every question can also be answered ahead of time, for Ansible or scripts.

Your own copy

Foundry VTT is downloaded from the Timed URL on your own license page, straight into the container. foundry-ops never includes, caches or redistributes it.

Runs like a service

Foundry runs under systemd as its own system user, with the Node.js version its package asks for, UPnP off, and settings for an HTTPS reverse proxy if you use one.

Updates you can undo

Run update in the container to install a newer Foundry. It can archive your user data first and keeps the previous version for a rollback.

Get started

  1. Run the install command in your Proxmox VE host’s shell.
  2. When it asks, paste a fresh Timed URL for the Node.js package from your Foundry license page. It is valid for 5 minutes.
  3. Open Foundry on port 30000 of the new container and enter your license key.

You’ll need a Proxmox VE host and a Foundry VTT license.

Read the install guide

Planned

Not available yet. On the roadmap:

  • Backup and restore
  • Cloning a server to a staging container
  • Optional Caddy in the container, for setups without a reverse proxy
  • A test matrix: Foundry 12, 13 and 14, fresh installs and updates

Your license, your server

foundry-ops has no accounts or telemetry of its own. It runs on your Proxmox host and in the container it creates, and downloads Foundry only from the link you give it. The community-scripts engine it builds on asks once per host whether to send anonymous install statistics to that project.

foundry-ops is not affiliated with or endorsed by Foundry Gaming LLC. Foundry Virtual Tabletop is © Foundry Gaming LLC and licensed separately; foundry-ops never includes or redistributes it.

What foundry-ops connects to