This guide covers setting up and configuring your Foundry Virtual Tabletop (VTT) server on Legion Hosting. Foundry VTT is a self-hosted platform for playing tabletop roleplaying games online with rich maps, automation, and game system support. For admin features and module management, see our Foundry VTT Admin and Module Guide.
What is Foundry VTT?
Foundry Virtual Tabletop is a premium, self-hosted application for playing tabletop RPGs online. Unlike browser-based alternatives, Foundry VTT runs as a dedicated server that players connect to through their web browser, providing rich features for Game Masters and players alike.
Key features include:
- Game System Support — Play D&D 5e, Pathfinder 2e, Call of Cthulhu, and hundreds of other systems through community-built game system packages
- Dynamic Lighting — Real-time lighting and vision with line-of-sight calculations for immersive dungeon exploration
- Audio/Video — Built-in audio playlists and optional A/V chat integration
- Module Ecosystem — Thousands of community modules for automation, UI enhancements, and content
- Web-Based Players — Players connect via any modern web browser with no software installation required
Prerequisites
Foundry VTT requires a valid license key to operate. You must purchase a license from the official Foundry VTT website before setting up your server.
First Start
When your Foundry VTT server is provisioned on Legion Hosting:
- Log in to GPanel at gpanel.legionhosting.net
- Select your Foundry VTT server from the server list
- Review the Startup Variables — enter your Foundry VTT license key if a variable is provided
- Click Start to launch the server
- The server will start and provide a URL for the setup wizard
- Open a web browser and navigate to
http://YOUR_IP:PORTto access the Foundry VTT setup screen - Enter your license key and admin password when prompted
GPanel Startup Variables
GPanel may provide startup variables for basic Foundry VTT configuration:
| Variable | Description | Example |
|---|---|---|
TIMED_URL |
Timed download URL from your foundryvtt.com profile. Required to download Foundry VTT files. The link expires after about 5 minutes. | https://foundryvtt.s3.amazonaws.com/... |
FOUNDRY_LANGUAGE |
Interface language for Foundry VTT | en.core |
UPDATE_CHANNEL |
Update channel: release, testing, or development |
release |
Configuration (options.json)
Foundry VTT's main configuration is stored in data/Config/options.json. You can edit this through GPanel's File Manager:
{
"port": 30000,
"upnp": false,
"fullscreen": false,
"hostname": null,
"localHostname": null,
"routePrefix": null,
"sslCert": null,
"sslKey": null,
"awsConfig": null,
"dataPath": "/home/container/data",
"compressStatic": true,
"proxySSL": false,
"proxyPort": null,
"minifyStaticFiles": true,
"updateChannel": "stable",
"language": "en.core",
"world": null
}
Configuration Settings
| Setting | Description |
|---|---|
port |
The port Foundry VTT listens on. Usually managed by GPanel. |
dataPath |
Path to the user data directory containing worlds, systems, and modules. |
world |
Set to a world name to automatically launch that world on server start. Set to null to show the setup screen. |
upnp |
UPnP port forwarding. Leave as false on hosted servers. |
compressStatic |
Enable gzip compression for static files. Recommended true for better performance. |
updateChannel |
Update channel: stable, testing, or development. |
world option to a world name (e.g., "my-campaign") will skip the setup screen and launch directly into that world. This is convenient but means you will need to access the setup screen via /setup URL path to manage worlds.
Creating Your First World
After completing the initial setup:
- Access Foundry VTT in your browser at
http://YOUR_IP:PORT - Enter your admin password to reach the setup screen
- Go to the Game Systems tab and install a game system (e.g., D&D 5e, Pathfinder 2e)
- Go to the Game Worlds tab and click Create World
- Set a world name, select the installed game system, and configure initial settings
- Click Launch World to start playing
How Players Connect
Players connect to Foundry VTT through a standard web browser — no software installation is needed.
- Share your server URL with players:
http://YOUR_IP:PORT - Players open the link in any modern browser (Chrome, Firefox, Edge)
- On the login screen, players select their assigned player name and enter their password (if set)
- The Game Master (you) must have launched a world before players can connect
Data and Backups
Foundry VTT stores all data in the data/ directory:
data/worlds/— Your game worlds (maps, journals, actors, items)data/systems/— Installed game system packagesdata/modules/— Installed add-on modules
data/ directory via SFTP before making major changes, updating Foundry VTT, or modifying worlds.
Related Articles
- Foundry VTT Admin and Module Guide
- How to Find Your Server IP and Port
- How to Upload Files via SFTP
- Getting Started with Your New Server
Need Help?
If you need assistance with your Foundry VTT server, submit a support ticket and include your server ID and a description of the issue.