Getting your content into mudstack is the first step towards adopting an artist-first Digital Asset Manager (DAM) and Version Control System (VCS).

There are 2 different scenarios to consider— first time uploads and new version uploads.

First Time Uploads

Ideally, you have an existing directory on your local machine that is set up with the folder structure and file naming conventions you want to continue to use on mudstack.

Uploading Folders

Using the desktop application is currently the only way to maintain your folder structure during upload.

  1. Install the desktop app and log in to your mudstack account.

  2. Navigate to the Local area of the application and allow mudstack to manage the directory where your project content lives. This directory should be dedicated to a specific workspace in mudstack. Once mudstack has indexed this directory (this might take a while depending on the size of the directory), you can search and categorize the contents (via tags and libraries) locally.

  3. To send the contents of this directory to the cloud workspace, right-click and select Upload.

  4. Next, you can pick the account and workspace where this directory should be uploaded.

Depending on the size of the directory, this step could take several minutes or upwards of an hour.

Known bug: June 26, 2023 Uploading files this way is significantly slower than the method below and the progress indicator does not show. This will be fixed soon.

Single or Multi-File Uploads

If you just want to upload a handful of files (or even several hundreds) from a local folder into a cloud folder without having mudstack manage the directory, you can do that as well.

You can only add files, not folders, this way. This method works both in the browser and the desktop app.

To do this:

  1. Start in the location on the cloud workspace where you want to add the files. For instance, Workspace A > Folder 1 > Subfolder 1.1. From here, click the Upload files button and use your Windows Explorer or Mac Finder to locate and select the files you would like to add.

  2. After you select your files, you should see a progress indicator appear in the lower left of the screen that shows you an approximate time remaining and file completion count. Once all the files are finished uploading, the view should update to show all the newly added files.

New Version Uploads

Once the first version of a file is in the mudstack cloud, it is easy to add new versions without overwriting any older versions.

From Mudstack Local

  1. Find the file you want to upload a new version(s) for. Click to select.
  2. In the right sidebar, click the Versions tab.
  3. Pick the version you want to upload, add an optional description and click Commit, then Upload. How to upload a local version
  4. Select the account and workspace where you want to send this version to.

As long as the path of the file in your local folder matches the path of the file in the cloud workspace, the cloud file will receive the new version.

If the path does not match, then a new file will be created at the root of the workspace.

From the File View

When viewing a file in the mudstack cloud workspace, you can also navigate to the Versions section in the right sidebar and click the Upload button.

This method does not require you to ensure that the paths match— you can add a new version from anywhere on your local hard drive.

Syncing Files


Being able to selectively sync (up to and down from the cloud) files/folders/libraries is much more convenient than the manual method of uploading/downloading files.

We are actively developing this feature. It is slated for a November 2023 release.

Key requirements:

  1. Ensuring that the latest versions of synced files are available locally.
  2. Notifying users of any conflicts when they are working on a file locally and it has new versions available in the cloud.
  3. Providing options for conflict resolution.
  4. Easy uploads of new local versions.
  5. Non-destructive file versioning with painless rollbacks.