Enable sstate cache
===========================

sstate cache background
----------------------------------

To speed up the build process, sstate provides a cache mechanism, where sstate files from server can be reused to avoid build from scratch if the producer and consumer of the sstate have the same environment. With perfect case, we can achieve more than 80% time decreasing.

sstate cache server
----------------------------------

The default sstate files directory is sstate-cache under build dir. A mirror is available via sstate.karo-electronics.de.

On your local machine, add a ``conf/site.conf`` to the build dir as follows:

.. code-block:: text

  SSTATE_MIRRORS = " \
		file://.* http://sstate.karo-electronics.de/rocko/PATH;downloadfilename=PATH \
  "

The special "PATH" suffix is important as it is automatically expanded to the correct value for native packages (which are split by the host distribution being used).