Logchef

Logchef est une interface d'analyse de logs légère, single-binary, écrite en Go et conçue pour s'interfacer nativement avec ClickHouse comme moteur de stockage. Le projet se positionne comme une alternative moderne à Grafana Loki / Kibana pour interroger des téraoctets de logs structurés, avec un fo

Description

Logchef est une interface d'analyse de logs légère, single-binary, écrite en Go et conçue pour s'interfacer nativement avec ClickHouse comme moteur de stockage. Le projet se positionne comme une alternative moderne à Grafana Loki / Kibana pour interroger des téraoctets de logs structurés, avec un focus sur les requêtes SQL rapides et la visualisation.

L'outil fournit un explorateur web, un système de dashboards collaboratifs, une gestion fine des sources de données ClickHouse et un système d'authentification par équipes. Idéal pour les homelabs qui ingèrent déjà des logs dans ClickHouse (via Vector, Fluent Bit, etc.) et qui veulent une UI dédiée sans la lourdeur d'un Elastic stack.

Installation

services:
  logchef:
    image: ghcr.io/mr-karan/logchef:latest
    container_name: logchef
    restart: unless-stopped
    ports:
      - "7410:7410"
    volumes:
      - ./data:/data
    environment:
      - PUID=1000
      - PGID=1000
      - CLICKHOUSE_URL=tcp://clickhouse:9000
      - [email protected]
      - ADMIN_PASSWORD=changeme

⚠️ Adapte image/port/volumes selon le README officiel : https://github.com/mr-karan/logchef

Configuration

Définir CLICKHOUSE_URL (ou les variables CLICKHOUSE_HOST/CLICKHOUSE_PORT/CLICKHOUSE_USER/CLICKHOUSE_PASSWORD) pour pointer vers la base
Créer un compte administrateur initial via ADMIN_EMAIL / ADMIN_PASSWORD (sera créé au premier démarrage)
Brancher l'ingestion via Vector/Fluent Bit directement dans ClickHouse, Logchef ne fait que la lecture

Alternatives

Open source :

Grafana + Loki (stack classique, log agregation + dashboards)
Kibana (couche UI de l'Elastic stack)
HyperDX (alternative open source à Datadog, ClickHouse-native)
OpenObserve (ZincObserve) — observabilité unifiée, ClickHouse-based

Propriétaires :

Datadog Logs (SaaS leader, facturation à l'ingestion)
Better Stack (ex-Closed source Logs), Splunk, New Relic

Sécurité

Authentification obligatoire côté UI, comptes stockés en base ClickHouse
ClickHouse doit être placé sur un réseau privé (les requêtes SQL traversent Logchef, attention aux injections de paramètres)
Exposer Logchef uniquement derrière HTTPS avec un middleware d'auth (OIDC, Authentik)

Ressources

Métadonnées

Champ	Valeur
Nom	Logchef
Slug	`logchef`
Catégorie principale	[[cat-analytics]]
Langage	Go (28)
Stars	⭐ 757
Dernière MAJ	2026-05-25
Repo	github.com/mr-karan/logchef
Site	logchef.app