{"id":13563044,"url":"https://github.com/lensesio/lenses-docker","last_synced_at":"2025-06-11T16:43:02.156Z","repository":{"id":52708581,"uuid":"110097115","full_name":"lensesio/lenses-docker","owner":"lensesio","description":"❤for real-time DataOps - where the application and data fabric blends - Lenses","archived":false,"fork":false,"pushed_at":"2025-05-16T11:12:27.000Z","size":513,"stargazers_count":156,"open_issues_count":13,"forks_count":23,"subscribers_count":11,"default_branch":"master","last_synced_at":"2025-05-16T12:25:25.991Z","etag":null,"topics":["dataops","docker","enterprise","governance","kafka","kubernetes","openshift","security"],"latest_commit_sha":null,"homepage":"https://docs.lenses.io","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lensesio.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2017-11-09T09:51:44.000Z","updated_at":"2025-04-17T16:08:01.000Z","dependencies_parsed_at":"2023-02-14T06:55:12.329Z","dependency_job_id":"1be57584-34a3-449e-9b50-2f7d94dbce10","html_url":"https://github.com/lensesio/lenses-docker","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/lensesio/lenses-docker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lensesio%2Flenses-docker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lensesio%2Flenses-docker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lensesio%2Flenses-docker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lensesio%2Flenses-docker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lensesio","download_url":"https://codeload.github.com/lensesio/lenses-docker/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lensesio%2Flenses-docker/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259299323,"owners_count":22836509,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["dataops","docker","enterprise","governance","kafka","kubernetes","openshift","security"],"created_at":"2024-08-01T13:01:14.602Z","updated_at":"2025-06-11T16:43:02.112Z","avatar_url":"https://github.com/lensesio.png","language":"Shell","funding_links":[],"categories":["Shell"],"sub_categories":[],"readme":"# Lenses® for Apache Kafka\n\nThis is the official Docker for [Lenses](https://lenses.io/kafka-lenses) that\nenables you to:\n\n* View and Query Kafka Topic Data (Avro \u0026 JSon) - Browse and query with Lenses\n  SQL\n* View data topologies and monitor every aspect of your Kafka cluster\n* View and manage your Data Schemas\n* Build and monitor ETL pipelines with open source Kafka Connectors\n* Execute KStreams processors instrumented in SQL in Kubernetes or Connector\n  workers\n* Set up alerting and external notifications on liveniness of streaming systems\n* Data governance: Auditing on all actions, data lineage \u0026 multi-tenancy\n* Fine-grained security. Role based access with LDAP support\n* Manage Quotas, ACLs\n\nAs a state-less application lenses fits naturally in containers and run on\n**Kubernetes** or **Openshift**. It integrates and helps you instrument and view\nyour streaming data pipelines; as well as operate them with confidence !\n\nThe documentation is always available at https://docs.lenses.io and data\nengineering talk is on [Discourse](https://ask.lenses.io) and [Slack](https://launchpass.com/landoop-community)\n\n## The Docker Image\n\n**Please check out the\n[docker image documentation at docs.lenses.io](https://docs.lenses.io/current/installation/getting-started/docker/)\nfor the most recent docs and the complete set of features, settings and tweak\nknobs.**\n\n\nThis image is aimed for our enterprise clients, though anyone with a free\ndeveloper license may use it. Visit\nour [download page](https://lenses.io/downloads/) to get a free developer\nlicense or an enterprise trial.  Only Lenses is included in this docker. Our\ndevelopment environment image, which additionally includes Kafka, Connect,\nSchema Registry and our open-source Stream Reactor collection of connectors can\nbe found as `lensesio/box`.\n\nThis image has to be run alongside a Kafka cluster.\n\n\n## How to run\n\nIn the current iteration `lensesio/lenses` uses environment variables as the\nprimary means for configuration and alternatively configuration files.\n\n### Setup with environment variables\n\nFor any lenses configuration option, set an environment variable by converting\nthe option name to uppercase and with dots replaced by underscores. As an\nexample `lenses.port` should be converted to `LENSES_PORT`. Optionally settings\nmay be mount as volumes under `/mnt/settings` or `/mnt/secrets`. As an example\nyou could set —file— volume `/mnt/settings/LENSES_PORT` with the port number as\nthe content of the file.\n\nA brief example of a docker-compose file to setup Lenses, would be:\n\n```yaml\nversion: '2'\nservices:\n  lenses:\n    image: lensesio/lenses\n    environment:\n      LENSES_PORT: 9991\n\n      # # Users are managed within Lenses. Here you can change the superuser username:\n      # LENSES_SECURITY_USER: admin\n      # # Users are managed within Lenses. Here you can change the superuser password:\n      # LENSES_SECURITY_PASSWORD: admin\n    ports:\n      - 9991:9991\n      - 9102:9102\n    network_mode: host\n```\n\nThe docker image has two volumes where data are saved: `/data/log` for logs and\n`/data/kafka-streams-state` for storing the state of Lenses SQL\nprocessors. Depending on your queries and the topics volume, the latter can\nbecome pretty large. You should monitor space and plan for adequate\ncapacity. Maintaining the streams state directory between Lenses restarts is\nmandatory for the SQL processors to be able to continue from where they left.\n\nThe container starts with root privileges and drops to `nobody:nogroup`\n(`65534:65534`) before running Lenses. If you start the image as a custom\n`user:group`, it falls under your responsibility to make sure that the two\nvolumes are writeable by the custom `user:group`.\n\n### Setup with configuration files\n\nLenses software configuration is driven by two files: `lenses.conf` and\n`security.conf`. In the docker image we create them automatically from\nenvironment variables but it is possible to set directly these files instead.\n\nCreate your configuration files according to\nthe\n[documentation](https://docs.lenses.io/current/installation/configuration/) and\nmount them under `/mnt/settings` and `/mnt/secrets` respectively —i.e\n`/mnt/settings/lenses.conf` and `/mnt/secrets/security.conf`. You can set either\none or both together. Please for `lenses.conf` omit the settings\n`lenses.secret.file`. If by any chance you set them,\nyou have to make sure lenses can find the files described in these settings.\n\n## How to build\n\nIf you want to build the image yourself, you can just run:\n\n```bash\ndocker build -t lensesiolocal/lenses .\n```\n\nIf you are on an older version of Docker which does not support multi-arch\nbuilds, you can emulate a multi-arch build via args:\n\n```bash\ndocker build \\\n  --build-arg TARGETOS=linux --build-arg TARGETARCH=amd64 \\\n  -t lensesiolocal/lenses .\n```\n\n\n---\n\nFor more information, please visit\nour [documentation](https://docs.lenses.io/). Enterprise customers may use the\nsupport channels made available to them. Developer Edition users are encouraged\nto visit our [slack community](https://launchpass.com/landoop-community). We are\nalways happy to help and hear from you.\n\nWith respect,\n\nThe Lenses Team.\n\n---\n\nCopyright 2017-2023, Lenses.io Ltd\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flensesio%2Flenses-docker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flensesio%2Flenses-docker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flensesio%2Flenses-docker/lists"}