System Requirements

Hardware

Machine CPU RAM Storage Network
Coordinator 4 Cores 4 GB 10 GB (any storage device)

Static IP 1 Gbps
Initiator 4 Cores Minimum of 2 GB per hyperthreaded core on the machine (usually Physical cores *2), but we recommend at least double that (4GB). 30 GB (for diagnostic logs) + space required to successfully build the codebase under test. (SATA SSD or equivalent). We recommend doubling the space required to successfully build the codebase if possible. 1 Gbps
Helper   Minimum of 2 GB per hyperthreaded core on the machine (usually Physical cores *2), but we recommend at least double that (4GB). 11 GB (any storage device) 1 Gbps

Build Cache Host

8 Cores

16 GB

Size: At least twice the size required for build artifacts using this endpoint. Default 50GB.

When using a shared cache, there are additional requirements: 

Speed: 5,000 iops

Throughput: 500 MB/s

Windows pagefile size: must be larger than the redis database size. A general rule of thumb is that this should be 1.5-2 times larger than the RAM.

10 Gbps

Ports

  • The following ports must be open on the firewalls and network equipment (routers) of your Agent and/or Coordinator machines (details below). All port numbers can be changed during installation and in the Coordinator Manager.

    Port Required on Which Machines Notes
    443

    Coordinator

    		 Required for license activation and telemetry.
    8000

    Coordinator

    		 Incredibuild Manager Port: Enables communication with the Coordinator Manager user interface.
    31100

    Coordinator (internal)

    		 Coordinator Server Port: Enables the Coordinator Interface to communicate with the Coordinator Server.
    31104

    Coordinator

    		 Agent Communications Port: Enables the Coordinator to receive updates from your Agents.
    31105

    Agent

    		 Agent Service Port: Enables communication between the installed Agent and the Coordinator.
    31106-311xx

    Agent

    		 Helper Ports: One port is needed per core with a Helper Core license on each Agent.
    32103

    Coordinator

    SSL: Secured Communication with the Coordinator
    50052

    Coordinator (internal)

    		 License Service Port: Required to communicate with the license service. Only required for communication between Incredibuild components inside the Coordinator machine.

    5672

    Coordinator (internal)

    Message Transport Port: Used for communication between Incredibuild components. Only required for communication between Incredibuild components inside the Coordinator machine.

    4369

    Coordinator

    Required by RabbitMQ, which is used by Incredibuild. This port cannot be changed.

    51100

    Build Cache Endpoint

    Build Cache Port

    6379

    Build Cache Endpoint (internal)

    Redis port: Required for communication between Build Cache Service and Redis database internally in the Build Cache Endpoint machine.

Network

  • Network Bandwidth: Bandwidth includes both upload and download speeds. Minimum 1-10 Gbps, depending on your components (see table above).

  • Location: The machines should be on same physical LAN or connected through a VPN (same LAN is recommended).

  • Coordinator: The coordinator must have a static IP or a hostname recognized by DNS.

  • License Activation: Requires communication between the Coordinator machine
    and https://lvep.incredibuild.com:443 (our license validation service).

    • Proxy Management: If you are using a proxy to manage outbound communication for your on-prem machines, you should define a windows environment variable called HTTPS_PROXY with your proxy's URL as the value on your Coordinator machine. This allows us to route traffic through your proxy. The proxy must have a static IP or a hostname recognized by DNS.

      For example: https://my.proxyserver.com:1234 or https://85.90.30.8:1234.

      Incredibuild does not currently support proxies that require authentication.

  • Incredibuild Cloud: Incredibuild requires communication between all machines in your Incredibuild environment, as well as some communication with Incredibuild Cloud's management services. For details, see Cloud Network Requirements.

RabbitMQ

Incredibuild installs and uses RabbitMQ on the Coordinator, and the Coordinator cannot be installed on a machine that already has RabbitMQ installed.

Antivirus

The following should be excluded from the active antivirus on the Initiator Agent machine:

  • Incredibuild installation folder.

  • The folder of the source code that will be executed.

  • For Visual Studio – when using Incredibuild with Visual Studio, it is recommended to exclude Visual Studio installation folder. If the entire folder is not excluded, it is mandatory to exclude the following Visual Studio executables: 'devenv.exe', 'devenv.com', and 'MSBuild.exe'.

Storage

  • The initiator machine must use SATA or NVMe solid state storage for the source files and the output directories.

  • Another factor that influences the required storage space is the number of builds that IncrediBuild saves in the Build History database. The more builds you save, the more storage space you need. You can set this value in the Max builds to preserve in DB parameter in the Agent Settings dialog box.

Operating System

  • Supported Operating Systems:

    • Windows: 8.1, 10, 11

      • Windows 11 (or higher) is required for Intel CPUs gen 12 and later.

    • Windows Server: 2012 R2, 2016, 2019, 2022

    • 64-bit is required for: the Coordinator, Build Cache Endpoints, and Initiators using local Build Cache.

  • Permissions: Installation requires Power user permissions or higher.

Coordinator User Interface

  • Screen resolution: Recommended 1920 x 1080, Minimum 960 x 1080

  • Supported browser: Chrome 86 or higher with TLS 1.2 enabled.

Supported Tools

For details, see Supported Tools.