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.
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 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:
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.
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.
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.
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.
If you have any questions getting started with Redpanda and
rpk, please join our community Slack. You can always find our rpk command documentation here, and our full, source-available GitHub repository here.