Loreline

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:

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:

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

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

  1. 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.
  2. Open the file manager. It shows your server's Data folder.
  3. Go into the matching folder (for example worlds) and use Upload Folder, or drag the folder onto the list.
  4. 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.
  5. 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

  1. Start your server in Atlas and open your world link.
  2. On Foundry's first screen, enter your license key if you haven't yet.
  3. 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.
  4. Open a few scenes to check that maps, tokens and music load. A missing image usually means a folder name or place changed.
  5. 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.

Moving a big campaign?

Game Master has 40 GB of storage and 200 MB uploads. Open a support ticket if your move doesn't fit.

See plans

Questions

Will my players need new accounts?
No. Player users are stored inside the world, so they come across with it. Give your players the new world link.
My scenes show missing images after the move. What happened?
Scenes refer to files by their path inside 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.
Can you move the world for me?
Open a support ticket from Atlas with where your world is now and roughly how big it is, and we'll help you with the steps.
Can I move back later?
Yes. Download your folders from the Atlas file manager at any time. If you go back to an older Foundry version, use the copy you kept from before the v14 upgrade.

Related guides