The documentation you're currently reading is for version 2.8.1. Click here to view documentation for the latest stable version.
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.
Please note that only 64-bit architecture is supported.
Alternatively, you can use the StackStorm Docker image. You will need at least version 1.13.0 of Docker
engine, and optionally
docker-compose. See our Docker guide for more
This is the recommended minimum sizing for testing and deploying StackStorm:
If you split your filesystem into multiple partitions and mount points, ensure you have at least
1GB of free space in
/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: All current LTS releases are supported, from the time of their first
.1release - e.g.
16.04.1- until the Ubuntu end of life date. Currently we support Ubuntu
16.04. We aim to test and validate Ubuntu
18.04, when it is released later in 2018.
At that point, Ubuntu
14.04will be considered deprecated. It will continue to be supported until April 2019, when it goes end of life. No ongoing testing will be done with Ubuntu 14 after April 2019.
RHEL/CentOS: We currently support RHEL/CentOS
7.x. In general, we recommend using the most recent version in that series, but any version may be used. When RHEL
8.0is released, we will test and validate it. At that point, RHEL 6.x should be considered deprecated.
8.1is released, StackStorm support for RHEL
6.xwill finish. No ongoing testing will be done with RHEL
6.xafter that date.