Skip to content

Quickstart

  1. Start the server

    Terminal window
    docker compose up -d --build

    Kinglet is a single container backed by a volume — no Redis, no Kafka, no Postgres.

  2. Sign in as the administrator

    The first boot creates an admin account. If you didn’t set KINGLET_ADMIN_EMAIL / KINGLET_ADMIN_PASSWORD, the generated password is in the container logs and in admin-password.txt:

    Terminal window
    docker compose exec kinglet cat /data/admin-password.txt
  3. Open the UI and sign in

    Visit http://localhost:8080 and sign in with the admin email (default admin@kinglet.local) and that password. Hit Spray demo logs to watch the live tail, histogram, and filter bar do their thing.

  4. Create an API key and send a real event

    In /settings → projects & keys, create a key with the ingest scope, then:

    Terminal window
    curl -X POST http://localhost:8080/v1/events \
    -H "Authorization: Bearer kl_…" \
    -H "Content-Type: application/x-ndjson" \
    --data-binary '{"level":"info","message":"hello from my app","service":"my-app"}'

    It appears instantly — the UI subscribes over SSE while it’s live.