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


Ready to install StackStorm? Here’s an overview of how to get your system up and running.

StackStorm is distributed as RPMs and Debs for RedHat/CentOS and Ubuntu Linux systems, and as Docker images. You can either use a script to automatically install and configure all components on a single system, or you can follow the manual instructions for your OS.

Here’s an overview of the options:

  • One-line Install: Run our installation script for an opinionated install of all components on a single system. This is a our recommended way to get started. See the Quick Install section below for details.
  • Manual Installation: Have custom needs? Maybe no Internet access from your servers? Or just don’t like using scripted installs? Read the manual installation instructions for your OS (Ubuntu 14/16, RHEL/CentOS 6, RHEL/CentOS 7), and adapt them to your needs. Here’s some additional guidance for setting up an internal mirror for the StackStorm repos.
  • Ansible Playbooks: If you are an Ansible user, check these Ansible Playbooks for installing StackStorm. Ideal for repeatable, consistent, idempotent installation of StackStorm.
  • Docker: StackStorm is now supported on Docker - check out our Docker instructions.
  • Vagrant: Vagrant is a quick way to spin up a test system - see st2vagrant. This will bring up a new VM, and install StackStorm.

Choose the option that best suits your needs.

Upgrading to Brocade Workflow Composer? This is installed as a set of additional packages on top of StackStorm. You can either install StackStorm + Brocade Workflow Composer in one go, or add the Brocade Workflow Composer packages to an existing StackStorm system. If you are using Brocade Workflow Composer, you can also add Brocade Network Automation Suites. Read the Installing Brocade Workflow Composer documentation for more.

Quick Install

Grab a clean 64-bit Linux system that fits the system requirements. Make sure that curl is up to date using sudo apt-get install curl on Ubuntu, or sudo yum install curl nss on RHEL/CentOS. Then run this command:

curl -sSL | bash -s -- --user=st2admin --password='Ch@ngeMe'

This is an opinionated installation of StackStorm. It will download and install all components, as per the single host reference deployment. It assumes that you have a clean, basic installation of Ubuntu or RHEL/CentOS.

If you are trying to install StackStorm on a server with other applications, or local customisations, you may run into problems. In that case, you should use one of the manual installation methods.

The script itself is not idempotent. If you try to re-run the script on top of a failed installation, it fail. Start again with a clean system, or switch to a manual install.

If you’re installing behind a proxy, just export the proxy ENV variables http_proxy, https_proxy, no_proxy before running the script.

export http_proxy=
export https_proxy=
export no_proxy=localhost,

In case of MITM proxy, you may need to export additional proxy_ca_bundle_path, see Installing Packs from Behind a Proxy.

If you have problems accessing the Web UI on a RHEL 7/CentOS 7 system, check the system firewall settings.


For security reasons, the installer script enables authentication and generates random passwords for dependent services such as MongoDB and PostgreSQL.

If for some reason (e.g. debugging), you need to access those services directly you can find passwords in the config files - /etc/st2/st2.conf for MongoDB and RabbitMQ password and /etc/mistral/mistral.conf for PostgreSQL password.

Other Installation Options

For more details on reference deployments, or OS-specific installation instructions, see below: