Local

Start a Pinot cluster on your local machine.

Outcome

Start a multi-component Pinot cluster directly on your machine without containers.

Prerequisites

• JDK 11 or 21 (JDK 17 should work but is not officially supported)

• Apache Maven 3.6+ (only if building from source)

Steps

1. Download or build Apache Pinot

Download release

export PINOT_VERSION=1.4.0

wget https://downloads.apache.org/pinot/apache-pinot-${PINOT_VERSION}/apache-pinot-${PINOT_VERSION}-bin.tar.gz

See the Version reference page for the current stable release.

Extract and enter the directory:

tar -zxvf apache-pinot-${PINOT_VERSION}-bin.tar.gz
cd apache-pinot-${PINOT_VERSION}-bin

Build from source

Homebrew

2. Start ZooKeeper

./bin/pinot-admin.sh StartZookeeper \
  -zkPort 2181

3. Start Pinot Controller

export JAVA_OPTS="-Xms4G -Xmx8G"
./bin/pinot-admin.sh StartController \
    -zkAddress localhost:2181 \
    -controllerPort 9000

4. Start Pinot Broker

export JAVA_OPTS="-Xms4G -Xmx4G"
./bin/pinot-admin.sh StartBroker \
    -zkAddress localhost:2181

5. Start Pinot Server

export JAVA_OPTS="-Xms4G -Xmx16G"
./bin/pinot-admin.sh StartServer \
    -zkAddress localhost:2181

6. Start Pinot Minion (optional)

export JAVA_OPTS="-Xms4G -Xmx4G"
./bin/pinot-admin.sh StartMinion \
    -zkAddress localhost:2181

7. Start Kafka (optional)

Only needed if you plan to ingest real-time streaming data.

./bin/pinot-admin.sh StartKafka \
  -zkAddress=localhost:2181/kafka \
  -port 19092

Verify

Check that the Controller is healthy:

curl localhost:9000/health

The response should return OK. You can also open the Pinot Query Console at http://localhost:9000.

Next step

Your cluster is running. Continue to First table and schema to load data.