Installation

Installation

There are multiple ways to deploy and run EventLens depending on your environment.

1. Running with Docker (Recommended)

You can build the production image from the repository:

docker build -t eventlens:latest .

And run it by mounting your local config:

docker run --rm \
  -p 9090:9090 \
  -v "$(pwd)/eventlens.yaml:/app/eventlens.yaml:ro" \
  --name eventlens \
  eventlens:latest

The UI will be accessible at http://localhost:9090.

2. Running alongside your stack

If you use Docker Compose, you can define EventLens alongside your Postgres/Kafka containers:

services:
  eventlens:
    image: alphasudo2/eventlens-app:latest
    restart: on-failure
    environment:
      EVENTLENS_CONFIG: /app/eventlens.yaml
    volumes:
      - ./eventlens.yaml:/app/eventlens.yaml:ro
    ports:
      - "9090:9090"

3. Building/Running Local JVM

For local development or raw JVM environments, see Building from Source and JVM Deployment.

Return Home