# Running Pinot in Docker

{% hint style="success" %}
This is a quickstart guide that will show you how to quickly start an example recipe in a standalone instance and is meant for learning. To run Pinot in cluster mode, please take a look at [Manual cluster setup](https://docs.pinot.apache.org/release-0.9.0/basics/getting-started/advanced-pinot-setup).
{% endhint %}

{% hint style="info" %}
**Prerequisites**

Install [Docker](https://hub.docker.com/editions/community/docker-ce-desktop-mac)

You can also try [Kubernetes quick start](https://docs.pinot.apache.org/release-0.9.0/basics/getting-started/kubernetes-quickstart) if you already have a local [minikube](https://kubernetes.io/docs/tasks/tools/install-minikube/) cluster installed or [Docker Kubernetes](https://www.docker.com/products/kubernetes) setup.

If running locally, please ensure your docker cluster has enough resources, below is a sample config.
{% endhint %}

![](https://2944557471-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LtH6nl58DdnZnelPdTc%2F-MP84N_fClWXtze5DNeg%2F-MP85Vjrrdi47IKGBBGA%2Fimage.png?alt=media\&token=b2386992-f6d9-4b4c-a16d-5161f318cfb6)

We'll be using our docker image `apachepinot/pinot:latest` to run this quick start, which does the following:

* Sets up the Pinot cluster
* Creates a sample table and loads sample data

The following quick-start scripts are available 

* Batch example
* Streaming example
* Hybrid example

Before running the scripts, create an isolated bridge network `pinot-demo` in docker. This will allow all docker containers to easily communicate with each other. You can create the network using the following command - 

```
docker network create -d bridge pinot-demo
```

## Batch example

In this example we demonstrate how to do batch processing with Pinot.

* Starts Pinot deployment by starting
  * Apache Zookeeper
  * Pinot Controller
  * Pinot Broker
  * Pinot Server
* Creates a demo table
  * `baseballStats`
* Launches a standalone data ingestion job
  * Builds one Pinot segment for a given CSV data file for table `baseballStats`
  * Pushes the built segment to the Pinot controller
* Issues sample queries to Pinot

```bash
docker run \
    --network=pinot-demo \
    --name pinot-quickstart \
    -p 9000:9000 \
    -d apachepinot/pinot:latest QuickStart \
    -type batch
```

Once the Docker container is running, you can view the logs by running the following command.

```
docker logs pinot-quickstart -f
```

That's it! We've spun up a Pinot cluster. 

{% hint style="info" %}
It may take a while for all the Pinot components to start and for the sample data to be loaded. 

Use the below command to check the status in the container logs.

```
docker logs pinot-quickstart -f
```

{% endhint %}

Your cluster is ready once you see the cluster setup completion messages and sample queries, as demonstrated below.

![Cluster Setup Completion Example ](https://2944557471-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LtH6nl58DdnZnelPdTc%2F-M3HYOPyQmiTcY_MHzZo%2F-M3HrHz6he-Q02OvffGW%2Fimage.png?alt=media\&token=ab690a57-ee3f-41e6-893e-39296a0ddb20)

You can head over to [Exploring Pinot](https://docs.pinot.apache.org/release-0.9.0/basics/components/exploring-pinot) to check out the data in the `baseballStats` table.

## Streaming example

In this example we demonstrate how to do stream processing with Pinot.

* Starts Pinot deployment by starting
  * Apache Kafka
  * Apache Zookeeper
  * Pinot Controller
  * Pinot Broker
  * Pinot Server
* Creates a demo table
  * `meetupRsvp`
* Launches a `meetup` stream
* Publishes data to a Kafka topic `meetupRSVPEvents` to be subscribed to by Pinot
* Issues sample queries to Pinot

```bash
# stop previous container, if any, or use different network
docker run \
    --network=pinot-demo \
    --name pinot-quickstart \
    -p 9000:9000 \
    -d apachepinot/pinot:latest QuickStart \
    -type stream
```

Once the cluster is up, you can head over to  [Exploring Pinot](https://docs.pinot.apache.org/release-0.9.0/basics/components/exploring-pinot) to check out the data in the `meetupRSVPEvents` table.

## Hybrid example

In this example we demonstrate how to do hybrid stream and batch processing with Pinot.

1. Starts Pinot deployment by starting
   * Apache Kafka
   * Apache Zookeeper
   * Pinot Controller
   * Pinot Broker
   * Pinot Server
2. Creates a demo table
   * `airlineStats`
3. Launches a standalone data ingestion job
   * Builds Pinot segments under a given directory of Avro files for table `airlineStats`
   * Pushes built segments to Pinot controller
4. Launches a stream of flights stats
5. Publishes data to a Kafka topic `airlineStatsEvents` to be subscribed to by Pinot
6. Issues sample queries to Pinot 

```bash
# stop previous container, if any, or use different network
docker run \
    --network=pinot-demo \
    --name pinot-quickstart \
    -p 9000:9000 \
    -d apachepinot/pinot:latest QuickStart \
    -type hybrid
```

Once the cluster is up, you can head over to  [Exploring Pinot](https://docs.pinot.apache.org/release-0.9.0/basics/components/exploring-pinot) to check out the data in the `airlineStats` table.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.pinot.apache.org/release-0.9.0/basics/getting-started/running-pinot-in-docker.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.