kafka-ui/overview/getting-started.md

Getting started

We have plenty of docker-compose files as examples. They're built for various configuration stacks.

Guides

• SSO configuration
• AWS IAM configuration
• Docker-compose files
• Connection to a secure broker
• Configure seriliazation/deserialization plugins or code your own

Configuration File

Example of how to configure clusters in the application-local.yml configuration file:

kafka:
  clusters:
    -
      name: local
      bootstrapServers: localhost:29091
      schemaRegistry: http://localhost:8085
      schemaRegistryAuth:
        username: username
        password: password
#     schemaNameTemplate: "%s-value"
      metrics:
        port: 9997
        type: JMX
    -

• name: cluster name
• bootstrapServers: where to connect
• schemaRegistry: schemaRegistry's address
• schemaRegistryAuth.username: schemaRegistry's basic authentication username
• schemaRegistryAuth.password: schemaRegistry's basic authentication password
• schemaNameTemplate: how keys are saved to schemaRegistry
• metrics.port: open JMX port of a broker
• metrics.type: Type of metrics, either JMX or PROMETHEUS. Defaulted to JMX.
• readOnly: enable read only mode

Configure as many clusters as you need by adding their configs below separated with -.

Running a Docker Image

The official Docker image for UI for Apache Kafka is hosted here: hub.docker.com/r/provectuslabs/kafka-ui.

Launch Docker container in the background:

docker run -p 8080:8080 \
	-e KAFKA_CLUSTERS_0_NAME=local \
	-e KAFKA_CLUSTERS_0_BOOTSTRAPSERVERS=kafka:9092 \
	-d provectuslabs/kafka-ui:latest

Then access the web UI at http://localhost:8080. Further configuration with environment variables - see environment variables

Docker Compose

If you prefer to use docker-compose please refer to the documentation.

Helm chart

Helm chart could be found under charts/kafka-ui directory

Quick-start instruction here

Building With Docker

Prerequisites

Check prerequisites.md

Building and Running

Check building.md

Building Without Docker

Prerequisites

Prerequisites will mostly remain the same with the exception of docker.

Running without Building

How to run quickly without building

Building and Running

How to build and run