Note

The documentation you're currently reading is for version 3.1.0. Click here to view documentation for the latest stable version.

System Requirements

StackStorm requires Ubuntu, RHEL or CentOS Linux. It is not supported on any other Linux distributions. The table below lists the supported Linux versions, along with the Vagrant Boxes and Amazon AWS instances we use for testing. See below for more details about our Linux distribution support policy.

If you are installing from ISO, perform a minimal installation. For Ubuntu, use the “Server” variant, and only add OpenSSH Server to the base set of packages. All other dependencies will be automatically added when you install StackStorm.

Note

Please note that only 64-bit architecture is supported.

Linux (64-bit)

Vagrant Box

Amazon AWS AMI

Ubuntu 16.04

bento/ubuntu-16.04

Ubuntu 16.04 LTS - Xenial (HVM)

Ubuntu 18.04

bento/ubuntu-18.04

Ubuntu Server 18.04 LTS Bionic

RHEL 7 / CentOS 7

bento/centos-7.4

Red Hat Enterprise Linux (RHEL) 7.2 (HVM)

RHEL 6 / CentOS 6

bento/centos-6.7

Red Hat Enterprise Linux (RHEL) 6 (HVM)

This is the recommended minimum sizing for testing and deploying StackStorm:

Testing

Production

  • Dual CPU

  • 2GB RAM

  • 10GB storage

  • Recommended EC2: t2.medium

  • Quad core CPU

  • >16GB RAM

  • 40GB storage

  • Recommended EC2: m4.xlarge

Note

If you are planning to add the DC Fabric Automation Suite to your system later, you will need additional RAM. Check the DC Fabric Automation Suite System Requirements

If you split your filesystem into multiple partitions and mount points, ensure you have at least 1GB of free space in /var and /opt. RabbitMQ and MongoDB may not operate correctly without sufficient free space.

By default, StackStorm and related services use these TCP ports:

  • nginx (80, 443)

  • mongodb (27017)

  • rabbitmq (4369, 5672, 25672)

  • postgresql (5432)

  • st2auth (9100)

  • st2api (9101)

  • st2stream (9102)

If any other services are currently using these ports, StackStorm may fail to install or run correctly.

Linux Distribution Support Policy

StackStorm only support Ubuntu and RHEL/CentOS Linux distributions. In general, it is supported on the two most recent major supported releases for those distributions. Specifically:

  • Ubuntu: Current LTS releases are supported. Today this is 16.04 and 18.04.

    Support for Ubuntu 14.04 has been removed, as it is now End of Life. StackStorm 3.0 is the last release that supports Ubuntu 14.04.

  • RHEL/CentOS: We currently support RHEL/CentOS 6.x and 7.x. In general, we recommend using the most recent version in that series, but any version may be used.

    We are now beginning testing with RHEL 8.0. We anticipate adding support with StackStorm 3.2. When we add that support, we will remove support for RHEL 6.x. We expect that StackStorm 3.1 will be the last version that supports RHEL 6.x.