Set up RudderStack on Docker.

This guide will help you set up the RudderStack data plane in your Docker environment.

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

RudderStack Open Source

Follow these steps to set up the data plane if you’re using RudderStack Open Source:

  1. Download the rudder-docker.yml docker-compose file.
  2. Replace <your_workspace_token> in this file with your workspace token.
  3. In your terminal, navigate to the directory where you want to install RudderStack and run the following command:
docker compose -f rudder-docker.yml up -d

If you’re using an older version of Docker, run the following command:

docker-compose -f rudder-docker.yml up

Workspace token

The workspace token is a unique identifier of your RudderStack workspace. RudderStack uses this token to automatically read your source-destination configurations when you set up and run the data plane.

  1. Log in to your RudderStack Open Source dashboard.
  2. Copy your workspace token from Settings > Workspace:
Workspace Token
For more details on RudderStack Open Source, see Control plane setup.

Self-hosted control plane

If you are self-hosting your control plane using Control Plane Lite, see Docker instructions to set up your data plane.


Control Plane Lite is now deprecated and does not work with the latest rudder-server versions.

To set up and manage your connections, using the RudderStack-hosted control plane is strongly recommended.

Verify installation

To verify if the setup is successful, follow the steps listed in Verify installation.

Questions? Contact us by email or on Slack