Lenses requires two configuration files lenses.conf and security.conf. The configuration format is HOCON - a superset of JSON and properties files. No experience of HOCON is required. Like JSON, string values need to be quoted. Numbers and boolean values remain unquoted. For more information, please check the HOCON design document .


This file contains the main configuration options, such as the connection details for your brokers or the port Lenses uses. You have to create this file before Lenses can work. For a complete list of configuration options please refer to Options reference .

security.conf contains sensitive authentication configuration options.

The Lenses docker image and helm charts create these files automatically at startup.

Basic configuration 

A quick start example of lenses.conf looks like:

lenses.ip =
lenses.port = 9991

# License file
lenses.license.file = "/etc/lenses/license.json"

# Directory for local storage (write access needed) - preserve between upgrades
lenses.storage.directory = "/var/lib/lenses/storage"

# Bootstrap brokers
lenses.kafka.brokers = "PLAINTEXT://host1:9092,PLAINTEXT://host2:9092,PLAINTEXT://host3:9092"

A quick start example security.conf looks like:

# A single admin user
lenses.security.user = "admin"
lenses.security.password = "admin"