ubuntu/kafka repository overview

⁠kafka | Ubuntu

Current kafka Docker Image from Canonical⁠, based on Ubuntu. Receives security updates and rolls to newer kafka or Ubuntu release. This repository is free to use and exempted from per-user rate limits.

⁠About kafka

Current Apache Kafka Docker Image from Canonical, based on Ubuntu. Receives security updates and tracks the newest combination of Apache Kafka and Ubuntu. This repository is free to use and exempted from per-user rate limits.

⁠About Apache Kafka

Apache Kafka is an open-source distributed event streaming platform for high-performance data pipelines, streaming analytics and integrations. Read more on the Apache Kafka website⁠.

Please note that the images tagged up to 3.1 are Dockerfile-base images, whereas from version 3.6.1 onward the images are now rocks. As such the entrypoint is now Pebble. Read more on the Rockcraft docs⁠.

⁠Quickstart

To deploy a single-broker containerized Kafka, create a network first:

docker network create -d bridge kafka-network

Now, deploy the Apache Kafka service

docker run --detach \n  --name kafka \n  --network kafka-network \n  -p 9092:9092 \n  ubuntu/kafka:4.1-24.04_edge

To activate the Apache Kafka service, you need to format the logs directory and grant its ownership to the kafka user:

docker exec kafka \n  /opt/kafka/bin/kafka-storage.sh format \n  --standalone \n  --cluster-id $(cat /proc/sys/kernel/random/uuid | tr -d '-' | base64 | cut -b 1-22) \n  -c /etc/kafka/server.properties

docker exec kafka chown -R kafka:kafka /tmp/kraft-combined-logs/

⁠Tags and Architectures

Up to 5 years of free security maintenance on LTS channels.

Up to 10 years of customer security maintenance from Canonical's restricted repositories⁠.

Channel Tags shows the most stable channel for that track ordered stable, candidate, beta, edge. More risky channels are always implicitly available. So if beta is listed, you can also pull edge. If candidate is listed, you can pull beta and edge. When stable is listed, all four are available. Images are guaranteed to progress through the sequence edge, beta, candidate before stable.

⁠Commercial use and Extended Security Maintenance channels

If your usage includes commercial redistribution, or requires ESM or unavailable channels/versions, please get in touch with the Canonical team⁠ (or using [email protected]⁠).

⁠Usage

Launch this image locally:

docker run -d --name kafka-container -e TZ=UTC -p 9092:9092 ubuntu/kafka:3.1-22.04_beta

Access your Apache Kafka server at localhost:9092.

⁠Parameters

⁠Testing/Debugging

To debug the container:

docker logs -f kafka-container

To get an interactive shell:

docker exec -it kafka-container /bin/bash

⁠Debugging

To debug the container:

docker logs -f <kafka-container>

To get an interactive shell:

docker exec -it <kafka-container> /bin/bash

⁠Bugs and feature requests

If you find a bug in our image or want to request a specific feature, please file a bug here:

https://bugs.launchpad.net/ubuntu-docker-images/+filebug⁠

Please title the bug "kafka: <issue summary>". Make sure to include the digest of the image you are using, from:

docker images --no-trunc --quiet ubuntu/kafka:<tag>

⁠Deprecated channels & tags

These channels (tags) are not updated anymore. Please upgrade to newer channels, or reach out⁠ if you can't upgrade.