Linux archive



Download and extract in a location.

tar -xvf lenses.tar.gz -C lenses

The directory structure is:

   ├── lenses.conf
   ├── security.conf
   ├── license.json
   ├── bin/
   ├── plugins/
   └── logs/

Make sure the directory is owned by the root user.

The security configuration file contains information about the admin user account and password and LDAP connection details. Please make sure it is only readable by the Lenses user.

chmod 0600 /path/to/security.conf
chown [lenses-user]:root /path/to/security.conf

Lenses needs write access inside the directory it is running from and /tmp.

  • logs - In this directory two kinds of files are stored: log files and Lenses SQL processors (when in-process) state. To change the location for the processors’ state directory, use lenses.sql.state.dir option.

  • storage - Location for Lenses H2 database. To change this directory, use the lenses.storage.directory option.

  • tmp - Used for temporary files and JNI shared libraries. See here for instructions for JNI

Starting Lenses 

Start Lenses by running:


or pass the location of the config file:

bin/lenses lenses.conf

The default settings mean that you can login on http://localhost:9991 using your authentication provider, or with the admin account that comes by default with the admin:admin credentials. We strongly recommend changing the defaults .

To stop Lenses, press CTRL+C.

JNI libraries and code execution 

Lenses and Kafka itself use two common Java libraries that take advantage of JNI and are extracted to /tmp.

You must either:

  1. Mount /tmp without noexec
  2. or set org.xerial.snappy.tempdir and java.io.tmpdir to a different location
LENSES_OPTS="-Dorg.xerial.snappy.tempdir=/path/to/exec/tmp -Djava.io.tmpdir=/path/to/exec/tmp"

SystemD example 

If your server uses systemd as Service Manager, then manage Lenses (start upon system boot, stop, restart) with it. Below you can find a simple unit file that starts Lenses automatically on system boot.

Description=Run Lenses.io service

ExecStart=/opt/lenses/bin/lenses /etc/lenses/lenses.conf