wiki/Catalogue-Self-Hosted/apps/app-logdy.md

---
title: Logdy
created: 2026-06-07
updated: 2026-06-07
type: app
tags: [catalogue, logs, viewer, real-time, web-ui, cli, rust, single-binary, docker]
confidence: high
contested: false
sources: [https://selfh.st/apps/?tag=Logs, https://github.com/logdyhq/logdy-core]
---

# 📋 Logdy

> **Le viewer de logs en temps réel qui révolutionne le `tail -f`** : interface web moderne + mode CLI, parsing JSON automatique, single binary. Idéal pour le développement et le debug rapide.

## 📋 Informations Générales

| Champ | Valeur |
| :--- | :--- |
| **Site web** | [logdy.dev](https://logdy.dev/) |
| **GitHub** | [logdyhq/logdy-core](https://github.com/logdyhq/logdy-core) |
| **License** | MIT |
| **Langage** | Rust (core) + TypeScript (UI) |
| **Étoiles GitHub** | 2.2k ⭐ |
| **Dernière MAJ** | 2026-06-03 |
| **Catégorie** | [[cat-logs|Logs]] |

## 📝 Description

**Logdy** est un **viewer de logs en temps réel** qui transforme n'importe quel flux de logs (stdin, fichiers, syslog, Docker) en une **interface web moderne** accessible depuis le navigateur. C'est le successeur moderne du bon vieux `tail -f | grep` : même philosophie (simplicité), mais avec une UI qui permet de filtrer, chercher, parser et visualiser les logs structurés.

L'idée géniale de Logdy est de **s'intercaler** entre vos sources de logs (fichiers, containers Docker, services systemd, pipes) et votre terminal/navigateur. Le **binaire unique** peut être lancé en mode "demo" (avec des logs fake pour tester), en mode **CLI** (UI dans le terminal), ou en mode **Web UI** (HTTP server). Il parse automatiquement les logs JSON et propose des **colonnes typées** (timestamp, level, message) détectées depuis la structure.

**Public cible** : développeurs qui débuggent des apps locales, sysadmins qui veulent un `tail -f` visuel, petites équipes qui n'ont pas besoin d'une stack ELK/Loki complète, labos persos qui veulent du "just works".

- ✅ **Single binary** : un seul exécutable, zéro dépendance
- ✅ **Mode Web UI** : interface moderne accessible depuis le navigateur
- ✅ **Mode CLI** : UI dans le terminal (type k9s/lazygit)
- ✅ **Mode demo** : logs fake pour tester sans rien
- ✅ **Parsing JSON auto** : détection automatique des champs structurés
- ✅ **Recherche full-text** : full-text search avec highlighting
- ✅ **Filtres dynamiques** : ajout de colonnes et filtres à la volée
- ✅ **Multi-sources** : stdin, fichiers, Docker, journald, syslog
- ✅ **Authentification** : basic auth (optionnel)
- ✅ **WebSocket** : streaming temps réel ultra-rapide
- ✅ **MIT License** : utilisation libre, même commerciale
- ⚠️ **Pas de rétention long terme** : c'est un viewer, pas un aggregator

## 🚀 Installation

### Option 1 : Single binary (le plus simple)

```bash
# Téléchargement direct
curl -L https://github.com/logdyhq/logdy-core/releases/latest/download/logdy_linux_amd64 -o logdy
chmod +x logdy

# Mode demo
./logdy demo

# Suivre un fichier de logs
tail -f /var/log/syslog | ./logdy

# Forwarder les logs Docker d'un container
docker logs -f mon-container | ./logdy
```

### Option 2 : Docker

```yaml
# docker-compose.yml
version: '3.8'
services:
  logdy:
    image: logdyhq/logdy:latest
    container_name: logdy
    restart: unless-stopped
    command: web --port 8080 --config /home/appuser/.logdy/config.json
    ports:
      - "8080:8080"
    volumes:
      - /var/lib/docker/containers:/var/lib/docker/containers:ro
      - /var/run/docker.sock:/var/run/docker.sock:ro
      - logdy-data:/home/appuser/.logdy
    labels:
      - "traefik.enable=true"
      - "traefik.http.routers.logdy.rule=Host(`logdy.example.com`)"
      - "traefik.http.routers.logdy.entrypoints=websecure"
      - "traefik.http.routers.logdy.tls.certresolver=letsencrypt"

volumes:
  logdy-data:
```

### Option 3 : Homebrew / apt

```bash
# macOS
brew install logdy

# Linux (Debian/Ubuntu)
curl -L https://github.com/logdyhq/logdy-core/releases/latest/download/logdy_linux_amd64.deb -o logdy.deb
sudo dpkg -i logdy.deb
```

## ⚙️ Configuration Initiale

1. **Lancer Logdy** : `./logdy web --port 8080`
2. **Accéder à l'UI** : `http://IP:8080`
3. **Mode demo pour tester** : `./logdy demo` (logs fake pendant 60s)
4. **Connecter une source** :
   - Stdin : `cat app.log | logdy`
   - Docker : `docker logs -f container | logdy`
   - Fichier : `tail -F /var/log/app.log | logdy`
5. **Activer l'auth** : `logdy web --auth username:password`
6. **Personnaliser les colonnes** : UI > Columns > Add Column (extraction regex/JSON path)
7. **Setup les filtres persistants** : UI > Filters > Save

## 🔄 Alternatives

### Open Source
- **Dozzle** — Viewer de logs Docker (spécialisé Docker)
- **LoggiFly** — Monitoring + notifications Docker
- **Swan** — Dashboard syslog/SSH
- **lnav** — Viewer TUI (terminal)
- **klogg** — Viewer GUI C++ (cross-platform)
- **Kubetail** — Spécialisé Kubernetes

### Comparaison Logdy vs autres

| Critère | Logdy | Dozzle | lnav | Kubetail |
| :--- | :--- | :--- | :--- | :--- |
| **Mode** | Web/CLI | Web | TUI | Web/TUI |
| **Docker focus** | ✅ | ✅✅ | ❌ | ❌ |
| **Kubernetes focus** | ❌ | ❌ | ❌ | ✅✅ |
| **Multi-sources** | ✅ | ❌ | ✅ | ❌ |
| **Parsing JSON** | ✅ Auto | ✅ | Manuel | ✅ |
| **Recherche** | Full-text | Filtres | Full-text | Filtres |
| **Auth** | ✅ | ❌ (reverse proxy) | N/A | ✅ |
| **Single binary** | ✅ | ❌ (Go + assets) | ✅ | ❌ |
| **Setup** | <1 min | 2 min | 1 min | 2 min |
| **License** | MIT | MIT | GPL-2.0 | Apache-2.0 |

**Verdict** : Logdy est **le plus polyvalent** des viewers de logs. Si vous travaillez sur du Docker uniquement, [[app-dozzle]] (hors liste) est plus spécialisé. Si vous êtes sur Kubernetes, [[app-kubetail]] est imbattable.

### Propriétaires (ce que Logdy remplace)
- **Kaleidoscope** (diff de logs GUI, payant)
- **LogExpert** (Windows only)
- **BareTail** (payant)
- **Papertrail** (SaaS log viewer)
- **Loggly** (SaaS)

## 🔐 Sécurité

- ⚠️ **Logs = données sensibles** : Logdy affiche tout, attention à l'exposition
- ✅ **Chiffrement in-transit** : TLS obligatoire (Traefik en reverse proxy)
- ✅ **Authentification** : `--auth user:pass` pour l'UI web
- ✅ **Bind IP** : `--listen 127.0.0.1` si usage local uniquement
- ✅ **Pas de rétention** : Logdy n'archive rien, il stream juste (bon pour RGPD)
- ✅ **Pas d'indexation** : pas de base de données à compromettre
- ⚠️ **Docker socket** : si monté, c'est un accès root à l'hôte (utiliser un proxy type [[app-dozzle]])
- ✅ **Logs jetés au reboot** : aucun stockage persistant par défaut
- ✅ **Pas de backup nécessaire** : c'est un viewer stateless

## 📚 Ressources

- [GitHub logdyhq/logdy-core](https://github.com/logdyhq/logdy-core)
- [Documentation officielle](https://logdy.dev/docs)
- [Démo en ligne](https://logdy.dev/demo)
- [Quickstart video](https://www.youtube.com/@logdy)

## Pages Liées

- [[cat-logs]] — Catégorie Logs
- [[app-loki]] — Pour archiver long terme
- [[app-uptime-kuma]] — Monitoring uptime
- [[securisation-home-lab]] — Bonnes pratiques sécurité