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 |
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 internal communication in the Coordinator. 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
Network
-
Network Bandwidth: Bandwidth includes both upload and download speeds. Minimum 100 Mbps, recommended 1 Gbps or higher, and significantly higher for Build Cache Endpoints (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 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
Supported Tools
For details, see Supported Tools.