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,…
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
Variants
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
- Show HN: Logchef – Open-source schema-agnostic log viewer for ClickHouse (forum)
- Show HN: Logchef – Schema-agnostic log viewer for ClickHouse (forum)
- SQL is the best exploratory interface for LLMs. But, most of ... (other)
Collected today - public community threads