# 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, VictoriaLogs, or Grafana Loki — without adding a new storage.

Canonical page: https://ourlocalhost.com/app/8045/logchef

## Description

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: Mac, Linux, Any server.

## Desktop and other devices

Mac, Linux.

## Health score

79/100 (Good), based on 4 of 5 factors.
- Maintained: 100 (last commit 0 days ago)
- Popular: 59 (936 GitHub stars)
- Easy to install: 45 (3 install platforms, install notes)
- Security check: 94 (no serious findings, 1 minor, CI, tests)

## Links

- Official website: https://logchef.app/
- desktop: https://github.com/mr-karan/logchef/releases/latest
- GitHub: https://github.com/mr-karan/logchef
- Documentation: https://logchef.app/getting-started/quickstart

## 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.

## Alternatives

- 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

---
Source: Our Local Host (https://ourlocalhost.com/app/8045/logchef), the self-hosted and open-source app directory.
