Logchef

Logchef is an open-source, self-hosted log analytics workspace that lets teams search, tail, visualise, and set alerts on logs already stored in ClickHouse,…

  • Monitoring & Logging
Logchef is an open-source, self-hosted log analytics workspace that lets teams search, tail, visualise, and set alerts on logs already stored in ClickHouse, VictoriaLogs, or Grafana Loki — without adding a new storage layer.

Platform availability

Available on 3 of 10 platforms

  • Unraid (not listed)
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac
  • Windows (not listed)
  • Linux
  • Any server

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

79/100 Good

Maintained
100last commit 0 days ago
Popular
59936 GitHub stars
Easy to install
453 install platforms, install notes
Light to run
No data
Security check
94no serious findings, 1 minor, CI, tests

Based on 4 of 5 factors.

Availability: platform listings confirmed today

GitHub stars
936
Open issues
3
Last commit
2026-11-22
Latest release
v2.8.0
License
AGPL-3.0
Activity
declining

Checked today - source: GitHub (mr-karan/logchef)

Resources & Compatibility

Requirements not published yet.

Checked today - source: Docker Hub image tags and published docs

First-install notes

  • Docker start: all parts in one go Download the docker-compose.yml file (a Docker recipe) and run docker compose up -d, then open http://localhost:8125. It starts Logchef, ClickHouse (the log database), Dex (a login helper), and Vector (a log collector) together; if the Docker services are missing or stopped, the app cannot save logs and login may not work. source
  • Binary setup needs a secret and admin If you run the Logchef binary (the pre-built program), set LOGCHEF_AUTH__API_TOKEN_SECRET to a random value, then edit config.toml to set auth.admin_emails and enable [auth.local] for built-in password login. Logchef refuses to start without that secret, and without an admin email/local auth you may be locked out of the web UI. source
  • Install the CLI only if you need it For terminal commands, download the logchef-cli release that matches your OS and CPU type and move the binary to /usr/local/bin. This is optional for the web app but gives you the logchef command-line tool for managing or querying Logchef. source

Fetched today - each note links to its source

Alternatives (7)

  • ClickStack
  • Elasticsearch - Elasticsearch is a distributed search and analytics engine that indexes and queries full-text, log, metric, and vector data in near real ti…
  • Graylog - Graylog is a centralized log management platform built on open standards for capturing, storing, and analyzing terabytes of machine data in…
  • HyperDX - An open source observability platform: Unify session replays, logs, traces, and errors – all without the Datadog price tag.
  • Lila - Lila is the self-hostable open-source backend for Lichess, a free online chess platform for playing games, puzzles, tournaments, and commun…
  • kibana - Kibana is the data visualization layer for querying, analyzing, and managing data stored in Elasticsearch.
  • luau

Checked today - source: AlternativeTo

Common questions

What local setup gotchas should I expect when running Logchef?

The Docker quickstart starts Logchef, ClickHouse, Dex, and Vector, with the web UI on port 8125. For a binary install, set LOGCHEF_AUTH__API_TOKEN_SECRET to a random value and configure auth.admin_emails plus local password login. Stopped Docker services or missing binary auth can break log saving, login, or web access.

Where does Logchef store its metadata by default?

It uses a zero-config SQLite metadata store by default. The metadata store is also described as pluggable, so it can be changed from the default.

Does Logchef support Grafana Loki?

Yes, Logchef 2.8 adds Grafana Loki support alongside ClickHouse and VictoriaLogs. It can search, tail, visualize, and alert on logs already in Loki without adding another storage layer.

Can Logchef dashboards combine multiple log backends?

Yes, dashboards can place ClickHouse and VictoriaLogs panels on the same grid. They can be dragged and resized in place and can use time series, stat, breakdown, or table views.

What can the Logchef CLI do?

The CLI can query logs, run native SQL or LogsQL, run explain, histogram, fields, history, tail, doctor, and browser hand-off workflows against both supported sources.

Answers sourced from github.com, github.com, logchef.app

Community

Collected today - public community threads