This guide covers admin features, module installation, and management for your Foundry Virtual Tabletop server on Legion Hosting. For initial server setup, see our Foundry VTT Server Setup Guide.
Admin Access
Foundry VTT has two levels of access:
- Admin (Setup Screen) — Full server control including world management, system installation, and updates. Protected by the admin password set during initial setup.
- Game Master — In-world control over maps, actors, encounters, and player permissions. The GM is the world creator by default.
To access the admin setup screen at any time, navigate to http://YOUR_IP:PORT/setup and enter your admin password.
data/Config/options.json file via SFTP.
Installing Game Systems
Game systems define the rules and character sheets for your world (e.g., D&D 5e, Pathfinder 2e, Call of Cthulhu).
- Access the setup screen at
/setup - Go to the Game Systems tab
- Click Install System
- Browse or search the package list for your desired system
- Click Install next to the system
Installing Modules
Modules add features, automation, and content to Foundry VTT. Popular modules include Dice So Nice (3D dice), Token Vision Tweaks, and various automation tools.
From the Module Browser
- Access the setup screen at
/setup - Go to the Add-on Modules tab
- Click Install Module
- Browse or search for the module you want
- Click Install
From a Manifest URL
Some modules are distributed via manifest URL rather than the official package list:
- Copy the module's
module.jsonmanifest URL - In the setup screen, go to Add-on Modules > Install Module
- Paste the URL into the Manifest URL field at the bottom
- Click Install
Enabling Modules in a World
Installing a module makes it available, but you must enable it per-world:
- Launch your world
- Go to Settings > Manage Modules
- Check the box next to each module you want to enable
- Click Save Module Settings
- The world will reload with the modules active
User and Permission Management
Foundry VTT supports multiple user roles within each world:
| Role | Level | Description |
|---|---|---|
| Game Master | 4 | Full control over all world content, settings, and player management |
| Assistant GM | 3 | Can create and edit most content but cannot manage users or world settings |
| Trusted Player | 2 | Can create actors, items, and journal entries; can configure token settings |
| Player | 1 | Standard player role with limited permissions (can control assigned actors) |
| None | 0 | No permissions (observer only) |
To manage users:
- In your world, click the Players icon in the bottom-left sidebar
- Click the gear icon next to User Configuration
- Create user accounts, set roles, and assign passwords
- Share the appropriate credentials with your players
World Management
Creating Additional Worlds
You can run multiple worlds (campaigns) on the same server, but only one world can be active at a time:
- Go to the setup screen at
/setup - Under Game Worlds, click Create World
- Configure the world name, game system, and settings
- Click Create World to save
Switching Between Worlds
- From within a world, go to Settings > Return to Setup
- On the setup screen, click Launch World next to the desired world
Updating Foundry VTT
Updates to Foundry VTT can be applied from the setup screen:
- Access
/setup - If an update is available, a notification will appear at the top
- Click Update and select the version
- Wait for the update to download and install
data/ directory before updating Foundry VTT. Major version updates can break module and system compatibility. Check that your critical modules support the new version before updating.
Performance Tips
- Optimize Images — Use WebP format for maps and tokens. Large uncompressed images are the most common cause of performance issues.
- Limit Active Modules — Only enable modules you actively use. Each module adds overhead.
- Scene Management — Pre-load scenes before sessions and avoid extremely large maps (over 10,000 x 10,000 pixels).
- Compendium Packs — Store unused actors, items, and journal entries in compendium packs rather than keeping them in the world directory.
Uploading Content via SFTP
For large file uploads (maps, token packs, music), SFTP is faster than the built-in file browser:
- Connect to your server via SFTP (see How to Upload Files via SFTP)
- Navigate to the
data/directory - Upload files to the appropriate subdirectory (e.g.,
data/worlds/your-world/for world assets)
Related Articles
- Foundry VTT Server Setup 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.
