Local

Start a Pinot cluster on your local machine.

Outcome

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

Prerequisites

• JDK 25 or later (required for building and running Pinot services)

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

Note: The SPI and Java/JDBC client modules (pinot-spi, pinot-java-client, pinot-jdbc-client) remain compatible with Java 11 for external JVM consumers.

Steps

1. Download or build Apache Pinot

Download release

export PINOT_VERSION=1.5.1

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

Prerequisite: Install Apache Maven 3.6 or higher.

git clone https://github.com/apache/pinot.git
cd pinot
mvn install package -DskipTests -Pbin-dist
cd build

Homebrew

brew install pinot

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.