Try StarTree Cloud: 30-day free trial
Fixed host names

How to fix host names

In this recipe, we'll learn how to fix the host name of components in an Apache Pinot cluster.


To follow the code examples in this guide, you must install Docker (opens in a new tab) locally and download recipes.

Navigate to recipe

  1. If you haven't already, download recipes.
  2. In terminal, go to the recipe by running the following command:
cd pinot-recipes/recipes/fixed-hostname

Launch Pinot Cluster

You can spin up a Pinot Cluster by running the following command:

docker-compose up

This command will run a single instance of the Pinot Controller, Pinot Server, Pinot Broker, Pinot Minion, and Zookeeper. You can find the docker-compose.yml (opens in a new tab) file on GitHub.

Navigate to the Pinot UI (opens in a new tab) and you should see the following:

Pinot UI showing fixed host namesFixed hostnames

Configuring fixed host names

Let's have a look at the Docker Compose file (opens in a new tab) to see how we did this. The commands to start the container for each component are described below:


StartController -zkAddress zookeeper-fixedhost:2181 -controllerHost pinot-controller-fixedhost


StartBroker -zkAddress zookeeper-fixedhost:2181  -brokerHost pinot-broker-fixedhost


StartServer -zkAddress zookeeper-fixedhost:2181 -serverHost pinot-server-fixedhost


StartMinion -zkAddress zookeeper-fixedhost:2181 -minionHost pinot-minion-fixedhost