Step-by-step instructions for setting up RudderStack on Docker.

The Docker setup is the easiest and the fastest way to get up and running with RudderStack.


To install RudderStack on Docker, follow these steps:

  • Sign up and log into the RudderStack dashboard. Copy your workspace Token from the top of the page, as shown:

Why do I need to sign up on RudderStack?

RudderStack's dashboard (Control Plane) lets you set up your data pipelines by configuring event data sources and destinations. This dashboard is hosted by RudderStack and is free for open-source users.

If you don't wish to sign up for RudderStack, you can also set up your own control plane using the open-source RudderStack Config Generator. However, note that the control plane set up using the RudderStack Config Generator lacks certain features like Transformations and Live Events Debugger.

  • Download the rudder-docker.yml docker-compose file.

  • Replace <your_workspace_token> in the above file with the copied token.

  • Go to the directory where you want to install RudderStack and run the following command:

docker-compose -f rudder-docker.yml up
  • Once you have successfully followed the steps above, send test events to verify the installation.

Contact Us

In case you come across any issues while setting up RudderStack on Docker, feel free to contact us. You can also start a conversation on our Slack channel.