Intermediate Tips

Using the Unity Cache Server


Unity Cache ServerIf you’re working on a medium or big project then you may get into a situation when pulling your project from the repository (or switching to a different branch) triggers a time-consuming process of asset importing.  It can be even more painful if you’re targeting at mobile devices like Android and iOS. For instance, on iOS textures or lightmaps, the import may take even several hours! It’s a lot of wasted time because you cannot do anything during that time!

importing assets

Cache Server to the rescue!

The Unity editor, in order to preserve reasonable disk space, removes the imported asset data from the project’s Library folder for those assets that have been deleted. It also removes all assets data for the assets that need to be reimported when switching the target platform. This problem can be easily solved using the Cache Server!

The Cache Server is a separate piece of software that can be installed locally (if you’re working alone) or on a remote server. It collects all the imported asset data from the Library folder and stores all of them until the upper limit is reached (by default it is 50 GB).

Pre-requirements and installation

The Cache Server can be used only by Team License owners (Unity 4) or Unity 5 Professional users (Team License included).

To install the Cache Server, download it from the Unity homepage. The links are frequently updated (Cache Server version changes), so the best is to go there and download the latest version for yourself.

cache server download

After downloading the zip file, unpack it wherever you like to store the cache (locally or on a remote server). Then all you have to do is to double-click on RunWin.cmd file if you’re running it on Windows or open the terminal and execute ./ on Linux and Mac OS X hosts.

cache server files

Then you have to configure the Cache Server connection for your Unity editor. If there’s more people working on the same project and they have the access to the same server machine that the Cache Server is running on, they should follow this step too.

In the Unity go to the Preferences window. Then in the Cache Server section enable the Use Cache Server option and type in your server ip or hostname.


From now on, importing assets will first check for availability in our newly installed Cache Server, and then download it if present. Be aware that an asset will be present on the Cache Server if it was imported at least once after the Cache Server was enabled. Therefore, it may take some time before you notice the difference.

using cache server

4 thoughts on “Using the Unity Cache Server”

    1. Hello Mahesh,
      Yes, we’re using it in our team. It has a great advantage in using it in teams rather than using it alone – if somebody will import an asset, nobody else will need to re-import it again.

      I believe that Unity is building an import result based on asset checksum, so if two people have different asset version (different checksum), imported data is stored once for every asset variation. In this way there won’t be no conflict, and if they will merge at some point, cache server will provide a valid import data. This also means that Unity Cache Server requires a lot more space than the project itself, but it will remove old imports eventually.

Comments are closed.