> For the complete documentation index, see [llms.txt](https://docs.lenses.io/latest/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.lenses.io/latest/devx/5.5/getting-started/quickstart.md).

# Quick Start

This quick start guide will walk you through installing and starting Lenses using Docker, followed by connecting Lenses to your Kafka cluster.

{% hint style="warning" %}
We are no longer issuing Box licenses for Lenses 5. You can get the same functionality from the new [Lenses 6 version](https://docs.lenses.io/latest/getting-started/quickstart).
{% endhint %}

## Locally on your laptop <a href="#browser" id="browser"></a>

For a local quick start, you can use Lenses Box, an all-in-one docker, with Lenses, Kafka, Schema Registry and more. Lenses will start and be configured to connect to the built-in Kafka brokers.

1. To start with the Box you need a license. Please contact [us](mailto:sales@lenses.io).
2. Install and run the Docker

```bash
docker run --rm \
    -p 3030:3030 \
    --name=dev \
    --net=host \
    -e EULA="https://dl.lenses.stream/d/?id=CHECK_YOUR_EMAIL_FOR_KEY" \
    lensesio/box   
```

Open Lenses in your [browser](http://localhost:3030), log in with `admin/admin.`

For more information see [here](/latest/devx/5.5/deployment/installation/lenses-box.md).

{% hint style="info" %}
If you want to deploy via Helm see [here](#browser).
{% endhint %}

## Against your environment <a href="#browser" id="browser"></a>

{% hint style="success" %}
For production and automated deployments see [Installation](/latest/devx/5.5/deployment/installation.md).

Lenses starts in a bootstrap mode, this allows you to be guided through adding the minimum requirements for Lenses to start, a license, and connection details to Kafka.
{% endhint %}

### Prerequisites <a href="#browser" id="browser"></a>

1. Valid license - Lenses is a licensed product.
2. Kafka versions - Any version of Apache Kafka (2.0 or newer) on-premise and on-cloud.
3. Network connectivity - Lenses needs access to your Kafka brokers

### Start Lenses <a href="#start-lenses" id="start-lenses"></a>

Run the following command to pull the latest Lenses image and run it:

```bash
docker run --name lenses \
  -e LENSES_PORT=3030\
  -e LENSES_SECURITY_USER=admin \
  -e LENSES_SECURITY_PASSWORD=sha256:8c6976e5b5410415bde908bd4dee15dfb167a9c873fc4bb8a81f6f2ab448a918 \
  -p 3030:3030\
  -p 9102:9102 \
  lensesio/lenses:latest
```

Once Lenses has started, open Lenses in your [browser](http://localhost:3030), log in with `admin/admin.` You will be presented with the bootstrap UI that will guide you through connecting to Kafka.

The connection to your Kafka depends on your Kafka distribution, you can view more details in the [Connection to Environment section](/latest/devx/5.5/getting-started/connections.md).

<figure><img src="https://134554369-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPRZgA90zCIEh4nr20Dxr%2Fuploads%2FQJBcSJnCGdIAZwhhhrXy%2Fimage.png?alt=media&#x26;token=ddd32d7d-f5cc-4c0d-8a11-bd9d20c0c4f4" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.lenses.io/latest/devx/5.5/getting-started/quickstart.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.