Linux Installation - IncrediBuild Documentation

Last updated on Sep 16, 2025 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. 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