> ## 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.

# Build Acceleration

> Accelerate builds on your own infrastructure.

Incredibuild reuses cached outputs from previous builds and runs new work in parallel across your own
machines - faster builds, same workflow. Best for large C/C++, Unreal, and embedded projects.

Log in to [app.incredibuild.com](https://app.incredibuild.com/) and click **Accelerate Builds** in the
Getting started page, then choose your platform:

<Tabs>
  <Tab title="Windows">
    <Steps>
      <Step title="Install Incredibuild">
        Click **Download free trial**, then run the installer.
      </Step>

      <Step title="Run your first build">
        Run the same build **twice**, triggered the same way both times - the first run fills the
        cache, the second reuses it so only changed tasks rebuild.

        <Tabs>
          <Tab title="Visual Studio IDE">
            **Extensions → Incredibuild → Rebuild Solution**
          </Tab>

          <Tab title="Visual Studio CMD">
            ```bat theme={null}
            BuildConsole <solution> /cfg=<configuration> /rebuild /openmonitor
            ```
          </Tab>

          <Tab title="Make / Ninja">
            ```bat theme={null}
            BuildConsole /command="<your make/ninja command>" /openmonitor
            ```
          </Tab>
        </Tabs>
      </Step>

      <Step title="Distribute across helper agents (optional)">
        Open **Advanced acceleration → Add helper agents**, copy the generated command, and run it on
        each machine you want to contribute compute:

        ```bat theme={null}
        curl -k -o "%temp%\silent-installer.exe" "https://<your-coordinator>:8000/setup/silent-installer" && start /wait "" "%temp%\silent-installer.exe" /silent_installer /install /COORDINATOR=<your-coordinator> /COMPONENTS=[Agent]
        ```
      </Step>
    </Steps>
  </Tab>

  <Tab title="Linux">
    <Steps>
      <Step title="Install Incredibuild">
        Click **Download free trial**. Then, on your Linux machine:

        1. Copy the downloaded `install_incredibuild.sh` to the machine.
        2. Make it executable and run it as root:

        ```bash theme={null}
        chmod +x install_incredibuild.sh && sudo ./install_incredibuild.sh
        ```

        To use a custom install directory, pass it as an argument, e.g.:

        ```bash theme={null}
        sudo ./install_incredibuild.sh /custom/path
        ```
      </Step>

      <Step title="Run your first build">
        Run the same build **twice**, triggered the same way both times. No changes to your source or
        build scripts - just prefix your normal build command with `ib_console`:

        <Tabs>
          <Tab title="Make">
            ```bash theme={null}
            ib_console make -j 100
            ```
          </Tab>

          <Tab title="CMake">
            ```bash theme={null}
            ib_console cmake --build . -j 100
            ```
          </Tab>
        </Tabs>

        `-j` sets the max concurrent tasks - about 20% above your grid's core count.
      </Step>

      <Step title="Distribute across helper agents (optional)">
        Open **Advanced acceleration → Add helper agents**, copy the generated command, and run it on
        each machine you want to contribute compute:

        ```bash theme={null}
        IB_INSTALLER=$(mktemp --suffix=.run) && curl -fSL -o "$IB_INSTALLER" 'https://downloads.incredibuild.com/incredibuild_4.29.1.run' && chmod +x "$IB_INSTALLER" && sudo "$IB_INSTALLER" --action install --initiator enabled --helper enabled --data-dir '/incredibuild/' --coordinator-machine '<your-coordinator>'
        ```
      </Step>
    </Steps>
  </Tab>

  <Tab title="Mac">
    Select **Mac**, then **Book free assessment meeting** to get set up with an Incredibuild expert.
    Once you're set up, running builds and adding helper agents work the same as on Linux.
  </Tab>
</Tabs>

<Tip>Review timings and cache hit rate for each run on the [Builds](/console/builds) page.</Tip>

## What's next

<CardGroup cols={2}>
  <Card title="Manage your grid" icon="server" href="/console/manage/grid-settings">
    Adjust grid and agent settings from the Incredibuild Console.
  </Card>

  <Card title="Builds & analytics" icon="chart-line" href="/console/analytics">
    Track build times and cache performance.
  </Card>
</CardGroup>