You decide which services we may enable for analytics, personalization, and external content.
We use cookies and similar technologies on our website to personalize content, embed external media, and better understand how individual areas are used.
Necessary cookies
These entries support essential functions such as security, stability, and form processing.
Optional sections
AnalyticsMarketingPersonalizationExternal media
Your data may be processed with your consent or on the basis of legitimate interests. In the cookie settings, you can reject or explicitly allow each optional category.
Some services process personal data in third countries. By consenting, you also agree to this transfer. You can find more information in our Privacy Policy.
You can reopen and change your selection at any time. · 1.0.2
Learn how to fix common issues with your Foundry VTT server—from licenses and downloads to passwords and modules → Find out more
10 November 20263 min read0 Views0 helpful
Introduction
Can't open the Foundry interface, your password isn't working, or a world won't start anymore? Don't worry—most issues with your Foundry Virtual Tabletop server have a simple cause. Here we'll cover the most common issues and how to fix them quickly.
FAQ
Frequently asked questions
Check that your server is online and that your license details are entered in the startup parameters. Foundry can't be installed without valid license details. Check the Console for clues.
The link is only valid for a short time. Create a new link on foundryvtt.com using Timed URL, enter it right away, and restart your server—or enter Foundry Username and Foundry Password instead.
The password for setup is the Foundry Admin Key. Copy it from the Foundry VTT card in your game server's Overview.
A world must be running. Players need the full address, including the port, and a user account with a password in the world.
Modules or systems are usually incompatible with the new Foundry version. Update them in setup, and try disabling any suspicious modules under Manage Modules.
Feedback
Was this article helpful?
Your feedback helps us prioritize and improve content.
0 of 0 Users found this article helpful.
Personal support
Need more help than the guide provides?
Our ZAP support team knows your product — briefly describe your issue and we'll help you personally.
Navigation
Foundry Virtual Tabletop
Issues and solutions
The first place to check when something goes wrong is your game server's Console. For Foundry, it's a log viewer only: you can see whether Foundry was downloaded and started, and what errors occurred along the way.
Startup and license
Can't open the interface
First, check the Overview to see if your server is online. After starting or installing it, the interface may take a moment to become available.
If it's still unavailable after that, your license details are usually missing. When you start your server for the first time, it downloads Foundry using your license details. Foundry can't be installed without valid entries in the startup parameters—Foundry Username and Foundry Password, or Foundry Release Url. You can find clues in the Console.
Download with the release URL fails
The download link from your Foundry account is only valid for a short time. If it expires before your server can use it, create a new link on foundryvtt.com under Purchased Software Licenses. Select the Node.js operating system and click Timed URL. Enter the new link directly in Foundry Release Url and restart your server right away.
Alternatively, enter Foundry Username and Foundry Password so you won't need a link.
Wrong license or prompt for license key
If you entered only a download link, Foundry will ask for your license key the first time you open it. Enter it there or in the Foundry License Key field in the startup parameters.
If your account has multiple licenses, Foundry will otherwise select one at random. To choose a specific license, enter its key or number in the Foundry License Key field—for example, 1 for the first one.
Access
Admin password for setup isn't working
The password for setup is the Foundry Admin Key. You'll find it listed as Password on the Foundry VTT card in your game server's Overview. It's best to copy it directly from there to avoid typos.
Settings in Foundry setup are gone after restarting
Your server recreates Foundry's configuration every time it starts. This means changes in the Configuration section of Foundry setup, such as a new administrator password, are lost the next time you restart. To change the administrator password permanently, use the Foundry Admin Key field in the Configuration tab under Startup Parameters.
Players can't join
Players can connect only when a world has been started in setup. Also check that your players are using the full address, including the port, and that there's a user with a password for them under Game Settings > User Management in the world. For more information, see our guide Worlds, Systems & Modules.
Worlds and modules
World won't start or errors occur after an update
The most common cause is modules or systems that aren't compatible with your Foundry version. In setup, check Add-on Modules and Game Systems for available updates, and install them.
If you can open the world, try disabling any suspicious modules under Game Settings > Manage Modules. Start with as few active modules as possible, then re-enable them one by one until you find the module causing the issue.
Interface loads slowly
Large map images, lots of tokens, and music files need to be transferred to every player when a scene loads. Use compressed image formats such as WebP whenever possible, and avoid unnecessarily large files. Also keep an eye on your server's resource usage in the Overview and under Statistics. If memory usage is constantly at its limit, upgrading your server can help.
Preventive measures
Regular backups can save you a lot of stress, especially before updating Foundry, systems, or modules. We already back up your game server automatically every day. With the ZapX Pass, you can also create your own backups at any time and restore them with a click—with ZapX Pass Pro, you can even schedule automatic backups.
Conclusion
These steps should help you solve the issue. If they don't, don't hesitate to contact our support team—we're here every day and happy to help! 🙂
Server hosting from €2.49 / month, online instantly, DDoS protection included.
Preferred source on Google
