On This Page

Home / Stream/ Deploying Cribl Stream Software· Manual Deployment·OS and System Requirements

OS and System Requirements ​

For a successful Cribl Stream deployment, verify that your system meets the minimum hardware and software specifications outlined below.

Leader Node Requirements ​

Given the Leader’s critical role in coordinating Worker instances, we recommend deploying it on a stable and highly available infrastructure.

All the quantities listed below are minimum requirements.

SpecificationRequirements
OS
  • Linux kernel >= 3.10 and glibc >= 2.17
  • Example distributions: Ubuntu 16.04, Debian 9, RHEL 7, CentOS Linux 7, 8, or CentOS Stream 9, SUSE Linux Enterprise Server 12, Amazon Linux 2
  • Tested so far on Ubuntu (14.04, 16.04, 18.04, and 20.04), CentOS 7.9, and Amazon Linux 2
System
  • 1 GHz (or faster), 64-bit CPU
  • 4+ physical cores*, 8 GB+ RAM - all beyond your basic OS/VM requirements
  • 5 GB free disk space
* We assume that 1 physical core is equivalent to 2 virtual/hyperthreaded CPUs (vCPUs)
Gitgit must be available on the Leader Node (details below)
Browser SupportThe five most-recent versions of Chrome, Firefox, Safari, and Microsoft Edge

Worker Node and Single-Instance Requirements ​

This section outlines the requirements for deploying Worker Nodes and Single-instance deployments. For a deeper understanding of these concepts, see Worker Nodes and Single-instance deployments.

Requirements ​

The Worker Node requirements are identical to Single-instance deployments. All quantities listed below are minimum requirements.

SpecificationRequirements
OS
  • Linux kernel >= 3.10 and glibc >= 2.17
  • Example distributions: Ubuntu 16.04, Debian 9, RHEL 7, CentOS Linux 7, 8, or CentOS Stream 9, SUSE Linux Enterprise Server 12, Amazon Linux 2
  • Tested so far on Ubuntu (14.04, 16.04, 18.04, and 20.04), CentOS 7.9, and Amazon Linux 2
System
  • 1 GHz (or faster), 64-bit CPU
  • 4+ physical cores, 8 GB+ RAM - all beyond your basic OS/VM requirements.
  • 5 GB free disk space (more if persistent queuing is enabled)
Gitgit must be available on the Leader Node. See details below
Browser SupportThe five most-recent versions of Chrome, Firefox, Safari, and Microsoft Edge
SELinux Supportenforcing mode is supported, but not required.

Requirements Considerations ​

Keep the following considerations in mind:

Cloud VM Recommendations ​

To fulfill the requirements using cloud-based virtual machines, see Recommended AWS, Azure, and GCP Instance Types.

Core Equivalency ​

We consider 1 physical core to be equivalent to:

  • 2 virtual/hyperthreaded CPUs (vCPUs) on Intel/Xeon or AMD processors
  • 1 (higher-throughput) vCPU on Graviton2/ARM64 processors

Memory Requirements ​

  • Each Worker Process can consume memory up to its maximum heap size, plus Node.js overhead, and additional memory that scales with configuration (e.g., Destination type and number).
  • Ensure your total host memory allocation covers the memory usage of all Worker Processes and OS requirements.
  • Continuously monitor Node memory usage, especially after configuration changes.
  • For additional details, see