Docker
Step-by-step instructions for setting up RudderStack on Docker.
This guide lists the steps required to set up RudderStack in your Docker environment.
The Docker setup is the easiest and the fastest way to get up and running with RudderStack.

Introduction

Installing and setting up RudderStack involves two key steps:
    Control Plane setup
    Data Plane setup
Refer to the RudderStack Architecture to know more about the RudderStack Control Plane and Data Plane.

Control Plane Setup

There are two ways you can set up the Control Plane. This section lists the steps involved in each of them.

Use RudderStack-Hosted Control Plane

Why do I need to sign up for RudderStack?
RudderStack's dashboard lets you easily set up your data pipelines by configuring your sources and destinations. It is fully hosted by RudderStack and is free for open-source users. You also get access to some important features like Transformations and a Live Events tab.
    Note and copy your workspace Token from the top of the page, as shown below. This will be required for setting up the Data Plane.

Self-Host the Control Plane

Use this option if you don't wish to sign up for RudderStack.
You can self-host your own Control Plane using the open-source Control Plane Lite utility.
Note that the Control Plane set up using Control Plane Lite lacks certain features like Transformations and Live Events tab.

Data Plane Setup

For RudderStack-Hosted Control Plane

To set up the RudderStack Data Plane in your Docker environment, follow these steps:
    Download the rudder-docker.yml docker-compose file.
    Replace <your_workspace_token> in this file with the token you copied in the previous section.
    Then, open your terminal, navigate to the directory where you want to install RudderStack, and run the following command:
    1
    docker-compose -f rudder-docker.yml up
    Copied!
    Once you have successfully followed the steps above, send test events to verify the installation.

For Self-Hosted Control Plane

If you have self-hosted the Control Plane using the open-source Control Plane Lite utility, follow these instructions to set up the RudderStack Data Plane on Docker.
Once you have successfully followed the steps above, send test events to verify the installation.

Contact Us

If you come across any issues while setting up RudderStack on Docker, you can contact us or start a conversation on our Slack channel.
Last modified 10d ago