---
title: Logchef
created: 2026-06-08
updated: 2026-06-08
type: app
tags: [catalogue, app, analytics, auto-hebergement]
confidence: medium
contested: false
sources:
  - https://selfh.st/apps/?search=logchef
  - https://github.com/mr-karan/logchef
---

# 📊 Logchef

> **Interface web mono-binaire Go pour explorer et visualiser des logs massifs stockés dans ClickHouse, façon Grafana pour les logs.**

## 📊 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](https://github.com/mr-karan/logchef) |
| **Site** | [logchef.app](https://logchef.app/) |

## 📝 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 Docker

```yaml
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
      - ADMIN_EMAIL=admin@example.com
      - ADMIN_PASSWORD=changeme
```

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

## 🔀 Reverse Proxy (Traefik)

```yaml
services:
  logchef:
    image: ghcr.io/mr-karan/logchef:latest
    labels:
      - "traefik.enable=true"
      - "traefik.http.routers.logchef.rule=Host(`logs.example.com`)"
      - "traefik.http.routers.logchef.entrypoints=websecure"
      - "traefik.http.routers.logchef.tls.certresolver=letsencrypt"
      - "traefik.http.services.logchef.loadbalancer.server.port=7410"
```

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

- [selfh.st/apps/?search=logchef](https://selfh.st/apps/?search=logchef)
- [GitHub](https://github.com/mr-karan/logchef)
- [Site officiel](https://logchef.app/)

## 🔗 Pages Liées

- [[cat-analytics]] — Catégorie analytics
- [[Catalogue-Self-Hosted]] — Hub principal
