How to move a Foundry VTT world to Loreline
A Foundry world is a set of folders: the world itself, the game system it uses, its modules, and your own maps and art. Moving it means copying those folders to your Loreline server with the Atlas file manager, then launching the world in Foundry. Where you start decides how you get the folders.
Updated 16 November 2026
Before you move: check your Foundry version
Loreline runs Foundry v14. A world made in v12 or v13 is upgraded the first time v14 opens it, and an upgraded world can't be opened in the older version again. So:
- Keep a copy of the world folder exactly as it is now. That copy is your way back.
- Check that your game system has a v14 release. On the system's page in Foundry's package list, look at the verified version.
- Expect some modules to lag behind a new Foundry version. Note which ones you rely on, and plan to update or replace any that don't support v14 yet.
Step 1: get your folders
From your own computer
Everything is in Foundry's user data folder. In Foundry, open Setup, then Configuration: the User Data Path setting shows where it is. The usual places are:
- Windows:
%localappdata%\FoundryVTT\Data - macOS:
~/Library/Application Support/FoundryVTT/Data - Linux:
~/.local/share/FoundryVTT/Data
Close Foundry before you copy anything, so no file is half-written.
From The Forge
Export your world from The Forge so you have the world folder on your computer. Images and audio you uploaded to The Forge's Assets Library are stored outside the world, so download that library separately. If you skip it, scenes open with missing maps and tokens.
From another host or your own server
Use the host's file manager or SFTP to download the Data folder, or at least the folders listed in step 2. Stop the world first if the host lets you.
Step 2: choose what to upload
worlds/your-world: the world itself, with its scenes, actors, journals and chat.systems/: the game system the world uses. You can upload it, or install it fresh from Atlas.modules/: the modules the world uses. Installing them fresh is often cleaner than uploading old copies, and it gets you their v14 releases.- Your own folders: wherever you keep maps, tokens and music inside
Data. Keep the same folder names and places, because scenes point at those exact paths.
You don't need Foundry's Config or Logs folders. Your license key is entered again on the new server.
Step 3: upload in Atlas
- Sign in to Atlas and open your world. If it is running, stop it, because changing files inside
worlds/while it runs can lose data. - Open the file manager. It shows your server's
Datafolder. - Go into the matching folder (for example
worlds) and use Upload Folder, or drag the folder onto the list. - Large folders: a single upload is limited to 100 MB on Adventurer and 200 MB on Game Master. Zip big folders in parts (for example one zip per few scenes' worth of maps), upload each zip, and press Unzip next to it.
- To install a system or module fresh instead, open Modules & game systems in Atlas and paste the package's manifest link.
Step 4: launch the world
- Start your server in Atlas and open your world link.
- On Foundry's first screen, enter your license key if you haven't yet.
- In Setup, your world appears on the Worlds tab. Launch it. If Foundry offers to migrate it to v14, that is the upgrade described above.
- Open a few scenes to check that maps, tokens and music load. A missing image usually means a folder name or place changed.
- Share your world link with your players. Their user accounts come across with the world, so they sign in as before.
Before your first session, press Back up now in Atlas so you have a clean starting point. Nightly backups take over from there. See how to back up Foundry VTT for what each kind of backup covers.
Game Master has 40 GB of storage and 200 MB uploads. Open a support ticket if your move doesn't fit.
Questions
Will my players need new accounts?
My scenes show missing images after the move. What happened?
Data. If a folder was renamed, moved, or left behind (for example a Forge Assets Library you didn't download), Foundry can't find it. Upload the missing folder to the same place it had before.