Skip to main content

Troubleshooting

Connecting to Kafka​

The connection fails from Docker​

localhost inside the container is the container itself. Use host.docker.internal or the server's real address. See Connecting from Docker.

It connects, then can't reach the brokers​

The broker is probably advertising an address Kafkador can't reach, such as localhost:9092. Set advertised.listeners to a reachable address.

The log says DNS resolution failed​

The container doesn't add your network's domain to short hostnames. Use dns_search or extra_hosts. See Short hostnames.

TLS connections fail with a certificate error​

If your brokers use a private or self-signed CA, upload a truststore.

I'm asked for a password every time​

A password typed when connecting isn't saved. To save one, use Settings → Security.

Setup and sign-in​

Where's the setup token?​

It's printed in the log at startup:

docker compose logs kafkador | grep -A1 "setup token"

I lost the admin password​

Set a new one with environment variables and restart.

Settings → Access can't be changed​

KAFKADOR_ACCESS_MODE is set. Remove it and restart, or change the variables instead.

A username is blocked​

Five wrong passwords for a username from one address block it for 15 minutes. Wait for the block to end.

Kafkador won't start with KAFKADOR_SETUP_AUTO​

With no sign-in, Kafkador has to listen only on this machine. Set server.address=127.0.0.1, or also set KAFKADOR_ACCESS_MODE.

Using Kafkador​

ACLs are unavailable​

Your brokers have no authorizer. Enable one.

My ACLs have no effect​

Clients on an unauthenticated listener are User:ANONYMOUS. If that's in super.users, they bypass every ACL.

Offset reset is blocked​

Kafka only allows a reset while the group has no active members. Stop its consumers first.

A record search stops early​

A filtered read stops at its scan limit. Choose fewer partitions or a later start.

Broker metrics are missing​

Kafkador reads metrics from the Confluent metrics topics. On a cluster that doesn't publish them, the metrics pages have no data.

Live view stops working behind a proxy​

Turn off response buffering for Kafkador. See the Nginx example.

Getting help​

Check the container's log first:

docker compose logs -f kafkador

If that doesn't explain it, open an issue with your Kafkador version and the relevant part of the log. Remove any hostnames or credentials you don't want to share.