System Requirements
Hardware
| Machine | CPU | RAM | Storage | Network |
|---|---|---|---|---|
| Coordinator | Minimum 4 Cores, Recommended 8 Cores | 4 GB | 10 GB (any storage device) |
Static IP 1 Gbps |
| Initiator | Minimum 8 Cores | Minimum of 2GB per hyperthreaded core (usually Physical cores *2), recommend at least 4GB per hyperthreaded core. | 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 | 4 Cores | 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 TCP ports are used by various Incredibuild services. Make sure your network level firewalls, and operating systems firewalls allow communication through these ports.
Most port numbers can be changed during installation and in the Coordinator Manager.
The following ports are used by the Coordinator to communicate with services running on the Internet:
| Service Name | Location | TCP Port | Used by | Can change? |
|---|---|---|---|---|
|
License validation |
lvep.incredibuild.com |
443 |
Coordinator |
No |
|
Telemetry |
telemetry.incredibuild.com/* |
443 |
Coordinator |
No |
The following ports are used by Incredibuild services within your grid:
| Service Name | Location | TCP Port | Used by | Can change? |
|---|---|---|---|---|
|
Incredibuild Manager |
Coordinator |
8000 |
Any UI and API client |
Yes |
|
Incredibuild Manager |
Coordinator |
8000 |
Initiators |
Yes |
|
Coordinator Service |
Coordinator |
31104 |
Agents (Initiators and Helpers) |
Yes |
|
Agent Communications |
Coordinator |
32103 |
Agents (Initiators and Helpers) |
Yes |
|
Agent Monitoring and Settings |
Coordinator |
50071 |
Agents (Initiators and Helpers) |
No |
|
Agent Service |
Agents (Initiators and Helpers) |
31105 |
Coordinator |
Yes |
|
Helper Services |
Helpers |
31106-311xx one port per core |
Initiators |
Yes |
|
Build Cache Endpoint |
Initiators |
51100 |
Initiators |
Yes |
|
Build Cache Endpoint |
Shared Build Cache Endpoints |
51100 |
Initiators |
Yes |
The following ports are used when Incredibuild for Cloud is enabled (see more details in Cloud Network Requirements):
| Service Name | Location | TCP Port | Used by | Can change? |
|---|---|---|---|---|
|
Incredibuild Cloud Orchestrator |
cloudapi.incredibuild.com |
443 |
Coordinator |
No |
|
Incredibuild Cloud Orchestrator |
cloudapi.incredibuild.com |
443 |
Helpers created by Incredibuild Cloud in your VPC |
No |
|
Azure Bloc Storage |
devicstorage.blob.core.windows.net |
443 |
Helpers created by Incredibuild Cloud in your VPC |
No |
|
Coordinator Session |
Cloud Helpers |
31105 |
Coordinator |
Yes |
The following TCP ports are used for internal communication inside between Incredibuild agents running on the same machine (Coordinator and Agents). Therefore, there is no need to open them in your network firewalls (this is informational only):
| Service Name | Location | TCP Port | Used by | Can change? |
|---|---|---|---|---|
|
Agent Monitoring |
Agents (Initiators and Helpers) |
50051 |
Agents (Initiators and Helpers) |
No |
|
Redis |
Initiators |
6379 |
Same Initiator |
Yes |
|
License Service |
Coordinator |
50052 |
Coordinator |
Yes |
|
Coordinator Service |
Coordinator |
31100 |
Coordinator |
Yes |
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: To activate your license see the requirements in the Ports table above.
-
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: To active Incredibuild for Cloud, see the requirements in the Ports table above, and also Cloud Network Requirements.
-
Telemetry: Telemetry for usage statistics (no personal or company sensitive data) is reported through telemetry.incredibuild.com. The following URL must be allowed: telemetry.incredibuild.com/* (that is, anything under this domain).
Antivirus
The following should be excluded from the active antivirus on any Agent machine:
-
Incredibuild installation folder.
-
Initiator specific:
-
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, Initiators using local Build Cache, and in a future release, also the Agents.
-
-
Permissions: Installation requires Power user permissions or higher.
-
Incredibuild Smart Compatibility Layer (SCL): A Linux host running Docker or Podman, that can run an Ubuntu 22.04 container (the SCL container runs Ubuntu 22.04)
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.