Linux Installation - IncrediBuild Documentation

Last updated on Mar 15, 2026 Build Cache can now be deployed on native Linux endpoints, providing enhanced stability, performance, and cost-savings. This requires Ubuntu 22.04 or later. Use the standalone installer to deploy Build Cache on Linux. Click here to download the installer for your version. The installer follows the following format: ibsetup_v10_[build-number]_linux_x86_64.ubin Installer options are organized into three sections: common, installation, and upgrade. Each section provides a detailed help message accessible via the --help option.

Common section

--help Copy

./ibsetup_v10_[build-number]_linux_x86_64.ubin --help
Usage:
        ibsetup_v10_[build-number]_linux_x86_64.ubin [<options>] | <operation> [<operation-options>]
options:
   -h, --help    - show help
   -v, --version - show version
operations:
   ibsetup_v10_[build-number]_linux_x86_64.ubin install <install options>
   ibsetup_v10_[build-number]_linux_x86_64.ubin upgrade <upgrade options>

--version Copy

./ibsetup_v10_[build-number]_linux_x86_64.ubin --version
10.29.0

Install section

Note: This installation is not automatically upgraded. Use the upgrade command as required. --help Copy

./ibsetup_v10_[build-number]_linux_x86_64.ubin install --help
Usage:
        ibsetup_v10_[build-number]_linux_x86_64.ubin install <options>
options:
   -h, --help                             - show help
   -P, --accept-eula                      - agree to the EULA
mandatory options:
   -A, --data-dir=<path>                  - directory for IB data
   -O, --incredibuild-manager-host=<host> - ip/hostname of Incredibuild Manager
options for End Point Service:
   -L, --incredibuild-manager-port=<port> - port of Incredibuild Manager [8000]
options for Build Cache Service:
   -Q, --build-cache-max-size=<size>      - maximum cache size of Build Cache in GB [50]
   -G, --build-cache-location=<path>      - directory for Build Cache [/etc/incredibuild_build_cache/build_cache]
   -S, --build-cache-service-port=<port>  - port of Build Cache Endpoint [51100]

Variable Name	Description
`--accept-eula`	Accepts the End User License Agreement and skips the license dialog during installation.
`--data-dir`=<path>	Required. Specifies the root directory used by the Build Cache service for data storage. There is no default value, but /etc/incredibuild_build_cache link to <path> will always be created.
`--incredibuild-manager-host`=<host>	Sets the IP address or hostname of the Incredibuild Manager. This value is passed to the EPS installer.
`--incredibuild-manager-port`=<port>	Sets the port of the Incredibuild Manager. This value is passed to the EPS installer. Default value is 8000.
`--build-cache-max-size`=<size>	Configures maximum size of cached data in GB. Default value is 50.
`--build-cache-location`=<path>	Sets the value of files cache directory (“fileSystem/cacheDirectoryLocation“ field in buildcache_service_config.json). Default value is /etc/incredibuild_build_cache/build_cache Note: /etc/incredibuild_build_cache is a link to root directory of data storage.
`--build-cache-service-port`=<port>	Build Cache service port. Default value is 51100

Upgrade section

Note: This installation is not automatically upgraded. Use the upgrade command as required. --help Copy

./ibsetup_v10_[build-number]_linux_x86_64.ubin upgrade --help
Usage:
        ibsetup_v10_[build-number]_linux_x86_64.ubin upgrade [<option>]
options:
   -h, --help              - show help
   -P, --accept-eula       - agree to the EULA

Variable Name	Description
`--accept-eula`	Accepts the End User License Agreement and skips the license dialog during installation.

Uninstall section

To uninstall existing installation Build Cache for Linux use following command: Copy

sudo /opt/incredibuild_build_cache/management/uninstall.sh

​Common section

​Install section

​Upgrade section

​Uninstall section

Common section

Install section

Upgrade section

Uninstall section