---
title: Guardian (Plex)
created: 2026-06-07
updated: 2026-06-07
type: app
tags: [catalogue, media-streaming, plex, monitoring, alerts, notifications]
confidence: medium
contested: false
sources:
  - https://selfh.st/apps/?tag=Media+Streaming
  - https://github.com/.../guardian-plex
---

# 🎬 Guardian (Plex)

> Service de monitoring léger pour [[app-plex]] : alertes sur sessions inhabituelles, transcodages échoués, et indisponibilité serveur.

## 📋 Informations Générales

| Attribut | Valeur |
|----------|--------|
| **Nom** | Guardian (Plex) |
| **Slug** | app-guardian-plex |
| **Description** | Surveilleur Plex — notifie en cas d'activité suspecte, downtime ou problème de transcodage |
| **Site officiel** | https://guardian-plex.app/ |
| **Repository** | https://github.com/guardian-plex/guardian |
| **Stars** | 173 ⭐ |
| **Licence** | MIT |
| **Langage principal** | Python |
| **Catégorie** | Media Streaming |
| **Tags** | [catalogue, media-streaming, plex, monitoring, alerts, notifications] |

## 📝 Description

Guardian est un daemon simple qui **surveille l'état d'un serveur [[app-plex]]** et déclenche des alertes via Discord, Telegram, [[app-ntfy]], email, ou webhook générique. Contrairement à [[app-tautulli]] qui est un dashboard complet (sessions actives, stats, etc.), Guardian reste focalisé sur l'essentiel : êtes-vous prévenu quand quelque chose va mal ?

Les vérifications incluent : serveur joignable ou pas, transcodages en échec répétés, nouvelles connexions depuis une IP inconnue, bibliothèque qui ne se met plus à jour, espace disque en dessous d'un seuil, et versions d'API dépréciées. Une politique de « failed-over-success » permet d'éviter le spam d'alertes.

Points forts : configuration YAML simple, image Docker légère, pas de base de données. Limites : ne propose pas de dashboard historique — à coupler avec [[app-replex]] ou [[app-tautulli]] pour la visualisation.

## 🚀 Installation

### Via Docker (recommandé)

```yaml
# docker-compose.yml
version: "3.8"

services:
  guardian-plex:
    image: ghcr.io/guardian-plex/guardian:latest
    container_name: guardian-plex
    restart: unless-stopped
    environment:
      - PLEX_URL=http://plex.local:32400
      - PLEX_TOKEN=***      - TZ=Europe/Paris
      - DISCORD_WEBHOOK=https://discord.com/api/webhooks/***      - NTFY_TOPIC=plex-alerts
    volumes:
      - ./config:/app/config
```

### Installation manuelle

```bash
git clone https://github.com/guardian-plex/guardian
cd guardian
pip install -r requirements.txt
python -m guardian --config ./config.yaml
```

## ⚙️ Configuration

- **Connexion Plex** : URL + X-Plex-Token (compte admin Plex).
- **Cibles d'alerte** : Discord, Slack, Telegram, [[app-ntfy]], email SMTP, webhook JSON.
- **Seuils** : disque libre minimum (%), nombre max de transcodages simultanés, durée max d'une session, IP autorisées (CIDR).
- **Fréquence** : check toutes les 5 min par défaut, configurable.
- **Mode maintenance** : désactiver temporairement les alertes pendant une opération manuelle.

## 🔗 Alternatives

- **Tautulli** — Référence complète : dashboard + alertes + stats, mais plus lourd à administrer.
- **Replex** — Dashboard multi-instances, alerting plus basique.
- **Healthchecks.io** — Surveillance générique (HTTP/TCP), pas spécifique Plex.
- **Uptime Kuma** — Monitoring générique, parfait pour vérifier juste l'uptime HTTP.

## 🔒 Sécurité

- Le `PLEX_TOKEN` est aussi critique qu'un mot de passe admin. Variable d'environnement, pas de commit.
- Si alerte email/SMTP : ne pas logger le mot de passe SMTP, le sortir en variable d'env.
- Tester régulièrement que les alertes partent (sinon fausse sécurité).
- Surveiller le volume des alertes : un flood peut masquer une vraie panne.

## 📚 Ressources

- Repository : https://github.com/guardian-plex/guardian
- Documentation : https://docs.guardian-plex.app/
- Tautulli (référence complète) : https://tautulli.com/
- ntfy : https://ntfy.sh/

## 🔗 Pages Liées

- [[cat-media-streaming]] (catégorie parente)
- [[app-plex]] — Serveur surveillé
- [[app-tautulli]] — Dashboard Plex complet
- [[app-replex]] — Dashboard multi-Plex
- [[app-ntfy]] — Notifications push self-hosted
- [[app-uptime-kuma]] — Monitoring générique
- [[app-traefik]] — Reverse proxy HTTPS
- [[securisation-home-lab]] — Bonnes pratiques