Setup and Run Apache Kafka on Ubuntu, Linux, or Mac OS

To get started with Apache Kafka on Ubuntu, Linux, or Mac OS, complete the instructions given in this quickstart tutorial.

Note: Your computer must have Java 8+ installed.

Downloading Apache Kafka

Go to Apache Kafka official download page at and download the latest stable binary version.

Download and install Apache Kafka on Ubuntu / Linux / Mac

After downloading is complete, extract it:

tar -xzf kafka_2.13-3.0.0.tgz
cd kafka_2.13-3.0.0

Starting Zookeeper and Apache Kafka

  1. Now, open a terminal, change your directory to kafka_2.13-3.0.0\bin and start Zookeeper by executing the command with config\ file:
  2. bin/ config/

    You need to make sure that Zookeeper started successfully.

  3. Next, open a new terminal and change the directory to kafka_2.13-3.0.0\bin. Finally, start Apache Kafka by executing the command with config\ file:
  4. bin/ config/

    You also need to make sure that Apache Kafka started successfully.

Creating a Topic

A topic is needed to store events. A topic in Kafka, is like a table in a database where data are stored. You can have multiple topics for different events.

To create a new topic, use the tool from the command line. Replace my-topic-name with the name of your topic:

bin/ --create --topic my-topic-name --partitions 5 --replication-factor 1 --bootstrap-server localhost:9092

You can also view details of the new topic by running the following command:

bin/ --describe --topic my-topic-name --bootstrap-server localhost:9092

Writing Events to the Topic

A Kafka client communicates with the Kafka broker to write events. After the events are written, the broker will store the events for as long as you want.

There are Kafka clients libraries, supported for different languages, using which we can send events to Kafka topics. An application that sends data to the Kafka topic is called a producer application.

You can also use the tool to start console Producer for writing events to the topic. By default, each entered line is treated as a separated event.

$ bin/ --topic my-topic-name --bootstrap-server localhost:9092
>This is my first event
>This is my second event
>This is my third event

The console Producer can be stopped by pressing Crtl+C at any time.

Reading Events from the Topic

A Kafka client communicates with the Kafka broker to read events.

You can use Kafka clients libraries in your application to read events from Kafka topics. An application that reads data from the Kafka topics is called a consumer application.

You can also use console Consumer client to read events that you created. Use the following command to read events:

bin/ --topic my-topic-name --from-beginning --bootstrap-server localhost:9092

You can stop the Consumer client by pressing Ctrl+C at any time.

Stopping the Kafka Services

  1. Stop the Kafka console Producer and Consumer clients.
  2. Next, stop the Kafka broker by pressing Ctrl+C.
  3. Lastly, stop the Kafka ZooKeeper by pressing Ctrl+C.

Import/Export Data as Streams of Events into Kafka

Sometimes, you may need to collect data from any existing relational databases or messaging system into Kafka. To achieve this, you can use Kafka Connect. Kafka connect is a tool that helps to stream data reliably and durably between Kafka and other external systems. Kafka Connect can collect data continuously from any external systems into Kafka and vice versa.