Porting the buildstream.conf

This document outlines breaking changes made to the user configuration in BuildStream 2.

Filename and parallel installation

The default filename to load user configuration remains unchanged, however, if you plan to install and use both versions of BuildStream on the same host, it is recommended to keep your BuildStream 2 configuration in a file named buildstream2.conf.

Working directories

The builddir and artifactdir have been removed in favor of the new cachedir.

BuildStream 1:

builddir: ${XDG_CACHE_HOME}/buildstream/build
artifactdir: ${XDG_CACHE_HOME}/buildstream/artifacts

BuildStream 2:

cachedir: ${XDG_CACHE_HOME}/buildstream/cache

Remote cache configuration

The configuration for remote artifact caches has been completely redesigned, please refer to the artifact cache configuration documentation for details on how to configure remotes in BuildStream 2.