> ## Documentation Index
> Fetch the complete documentation index at: https://docs.incredibuild.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Linux Installation

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](javascript:void\(0\);)

```
./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](javascript:void\(0\);)

```
./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](javascript:void\(0\);)

```
./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 <br /> 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](javascript:void\(0\);)

```
./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](javascript:void\(0\);)

```
sudo /opt/incredibuild_build_cache/management/uninstall.sh
```