Redpanda makes it easy to create a streaming data environment, while also keeping you API-compatible with Apache Kafka®. If you’re one of the many developers who already have Homebrew and Docker Desktop installed on your Mac, you can get up and running with Redpanda very quickly. In this post, we’ll show you how to install Redpanda and its command line interface,
rpk, in one minute or less.
The single fastest way to start using Redpanda on macOS
Most developers who use Mac already have Homebrew and Docker Desktop installed. In this case, you only need a single line of code to start using Redpanda:
brew install redpanda-data/tap/redpanda && rpk container start
This single command line will install both Redpanda, as well as its CLI, which is called
rpk. When you paste the above command into your terminal, you’ll see something like this:
rpk have been installed successfully, and you’ve created your first, single-node cluster! It’s that easy.
You can now use
rpk to interact with the node. But, first, here’s how you can get to this point if you don’t already have Docker and Homebrew installed on your machine
If you don’t have Docker or Homebrew installed
If you don’t already have Docker Desktop and Homebrew on your machine, don’t worry. It’s still very easy to install these tools and start using Redpanda. Here’s how to get set up with these prerequisites:
1. Install Docker Desktop
To install Docker on your Mac, go to this page and select the architecture-appropriate version of Docker Desktop to download for your machine.
Note that your macOS must be V10.15 or newer (Catalina, Big Sur, or Monterey versions) in order to run Docker.
2. Install Homebrew
Install Homebrew by copy the following script into your macOS terminal:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
With these prerequisites installed, you can now use the single command line above to start using Redpanda on your machine.
Have some fun with Redpanda and
Now that you have a one-node cluster up and running, you can use our list of rpk commands to experiment and interact with Redpanda.
Setting up a three-node cluster
To prepare your environment to start a new cluster, first purge your existing single-node cluster using
rpk container purge.
Now you can use
rpk container start -n 3 to start a new, three-node cluster.
You will see something like this:
Be sure to note the brokers listed in this output. You will need them to run commands in
You can now further interact with the cluster. Use
rpk to create a topic:
rpk topic create topic_name --brokers <broker_1><broker_2><broker_3>
Produce to your topic using:
rpk topic produce topic_name --brokers <broker_1><broker_2><broker_3>
Type a test message you want produced to your topic. For example:
If the message was produced correctly, you’ll get a message similar to the following:
Produced to partition 0 at offset 0 with timestamp 1646948687487.
To consume from the topic, run:
rpk topic consume topic_name --brokers <broker_1><broker_2><broker_3>
If the message was consumed correctly, you’ll get an output similar to this:
Congratulations! You just did your first bit of data streaming on Redpanda.
rpk command documentation for more commands you can use.
When you’re done working within your node or cluster, shut it down and delete the node(s) using
rpk container purge. This will clean up your streaming data environment.
Take the next step!
If you have any questions getting started with Redpanda and
rpk, please join our community Slack. You can also find our
rpk command documentation here, and our full, source-available GitHub repository here.
Join Our Newsletter
We’ll send you a helpful update every so often, but no spam.