Backing up your assets library locally

In this tutorial, we will explain how to synchronize your assets library with your local Foundry installation.

Note: This synchronization is only done one-way. It currently downloads your assets library to the local folder. It will not sync your local folder to your Forge installation. The Asset Sync feature is intended as a way to backup your assets, and as a way to retrieve assets uploaded to The Forge.

If you want to synchronize your local assets to your assets library, use the Import Wizard. We use the term “synchronization” because, after the initial download of your assets, only new and changed assets will be re-downloaded. This helps keep the synchronization faster than a full re-download.

The synchronization tool currently has other limits, as well. For security reasons, Foundry will not let you overwrite local files that are not media files, so a file with no extension or a .js file, etc… will not be overwritten. This should not be an issue as the assets library is meant primarily for media files (audio, video, images), so you will rarely encounter that issue.

Similarly, the synchronization tool will not overwrite existing local files, unless you tell it to. If it detects that a local file matches the remote file, changing the name of the file in your assets library, and redoing a synchronization will update the local file as well. If both the local and remote file have changed, the file will not be overwritten.

How to synchronize your assets library

1 - Install and enable the Forge VTT module to your local Foundry installation
2 - Set your API key in the Forge module’s settings. Refer to this guide on how to do this. Note that you would only need the ability to read assets in the API key permissions.
3 - In the same module settings window, open the Asset Sync Tool by clicking the “Open Asset Sync” button:


4 - Click the Sync button and let it begin working:


If you make changes to your assets library after syncing it to your local Foundry folder, all you will need to do is open the sync tool and re-sync them again. After the first sync, it will (usually) be faster and more efficient in subsequent syncs. In the future, the asset sync will allow you to update your worlds as well, allowing you to export your content more easily, and play offline.


Looking forward to the local world asset re-point, that’ll be great too.


Hey there,

  • is there a milestone set fot updating the world?
  • Do I have to resync completely (forced) to activate the later coming use of Local Assets
  • 181/11779 assets and I started like 15 minuets ago. Be patient everybody :slight_smile:

Very nice feature I was looking forward to. Thanks!


  • There’s no specific deadline set for it (I stopped doing deadlines, I always miss them, stress over them, and feel bad), but it’s for sooner rather than later.
  • Yes, you would resync but this is an assets sync not an assets download, and it took a while to write because we wanted you to be able to do the sync multiple times and it would just pick up any changes, without redownloading anything that hasn’t changed, so technically, the next time you do a sync, it should only take a few seconds to complete.
  • Yeah, initial sync can take a while, depending on how big your assets library is, hehe. We could probably optimize the download/upload portions to have it parallellized, but that’s a lower priority than other stuff.


Hey kakaroto, Alright sounds good to me. Thanks again for the (again fast) response. Have a nice weekend. After the 0.8.6 release I’m sure it’s a quite one :sweat_smile:

An update to the Forge module was released a couple of days ago which adds support for the updating of worlds. It will also attempt to migrate entities in compendiums in your enabled modules, so hopefully the world becomes fully usable offline (unless it’s using references to someone else’s asset library or external links).
Please test it and let us know if you have any issues or feedback!

Yeah, I’m now on story teller mow and uploaded (some) more assets now. Sooo I’m syncing another 30k assets right now and will test afterwards. Probably Saturday.
Will post any issues here or on discord.
Edit: with the speed of the sync right now it’ll be 25 hours till completion of the process. It’l be sunday or monday :sweat_smile:
Okay it skipped like 28k assets i synced earlier. The new feature synced with errors (expected ones). It shows the modules that the scene was using on the forge, but are not installed locally and shows external links as errors. Seems like it works as intended.

Console: Screenshot - 71c3d63396be29a9163975f2fc54ce18 - Gyazo

1 Like