Like Docker? So do we!

One of the quickest ways to get StackStorm running is using Docker. This page will show you the basics of how to use StackStorm with Docker.

For more detailed information and examples, check out the README at our st2-docker GitHub repo.


If you use Kubernetes, check the StackStorm HA Cluster in Kubernetes - BETA for more information.

Host Requirements

Docker Images

Docker-compose deployment relies on pre-built, tested and deployed to Docker Hub StackStorm images. Check out stackstorm/st2-dockerfiles GitHub repository if you need more details about the StackStorm Dockerfiles internals.


Assuming Docker engine and docker-compose are properly installed, getting started is easy.

First, clone the st2-docker repository. Unless specified otherwise, all subsequent commands assume they are run within st2-docker directory:

git clone
cd st2-docker

You may want to change some variables as necessary. The defaults should be okay. Below is the complete list of available options that can be used to customize your containers:




Tag at the end of the docker image (ie: stackstorm/st2api:v3.3dev).


The image or path to the images. Default is stackstorm/.


Port to expose st2web port 80 on. Default is, and you may want to do


Directory to development packs. This allows you to develop packs locally. Default is ./

Then, start the containers:

docker-compose up -d

This will pull the required images from Docker Hub, and then start them.

To switch to shell inside the container where you can use st2 CLI:

docker-compose exec st2client bash

Navigate the UI configured by default at http://localhost/. Username/Password pair is st2admin:Ch@ngeMe and could be configured via files/htpasswd.

To stop the containers, run:

docker-compose down

More information can be found in the st2-docker