Tous les tutoriels
Plexit

Tutoriel

Plexit

Version 1.0.0 · Mis à jour le 8 octobre 2026

PleXIT permet aux membres d'un serveur Discord de demander des films, séries ou animés qui seront ajoutés à un serveur Plex. Le tutoriel décrit l'installation du serveur PleXIT sur Debian ainsi que la configuration initiale. Vous apprendrez à lancer l'application, à la configurer et à l'utiliser via le site web.

Ce qu'il faut

  • Node.js version 20 ou supérieure
  • npm version 9 ou supérieure
  • Un serveur Plex accessible (local ou distant)
  • Un serveur Debian (ou autre distribution Linux) avec accès sudo

Installation

Debian / Linux

  1. 1Cloner le dépôt : git clone https://github.com/Heiphaistos/PleXIT-.git /home/user/plexit
  2. 2Se placer dans le répertoire : cd /home/user/plexit
  3. 3Copier le fichier d'exemple de configuration : cp .env.example .env.local
  4. 4Éditer .env.local et renseigner les valeurs (URL Plex, token, webhooks Discord, PIN admin, etc.)
  5. 5Lancer le script d'installation : bash install.sh (installe Node.js si nécessaire)
  6. 6Construire l'application : npm run build
  7. 7Démarrer le service avec PM2 : pm2 start npm --name "plexit" -- run start
  8. 8Installer le tunnel Cloudflare : bash deploy-debian.sh (installe cloudflared et crée le tunnel HTTPS)

Premier lancement

  1. 1Vérifier que le processus PM2 est actif : pm2 status
  2. 2Ouvrir un navigateur à l'adresse indiquée (ex. http://localhost:3001) ou l'URL publique fournie par Cloudflare
  3. 3Se connecter avec le PIN admin pour accéder à l'interface d'administration
  4. 4Tester une demande de film via le formulaire et vérifier la réception du webhook Discord

configurer le token Plex

Le token permet à PleXIT d'interroger votre serveur Plex.

  1. 1Ouvrir Plex Web et sélectionner un média
  2. 2Cliquer sur les trois points (…) puis sur « Obtenir infos »
  3. 3Choisir « Afficher le XML »
  4. 4Copier la valeur du paramètre X-Plex-Token dans .env.local (PLEX_TOKEN)

créer les webhooks Discord

Les webhooks transmettent les demandes et les statuts vers Discord.

  1. 1Dans Discord, ouvrir les paramètres du salon dédié aux demandes
  2. 2Aller dans « Intégrations » → « Webhooks » → « Nouveau webhook »
  3. 3Copier l'URL du webhook et la coller dans .env.local (DISCORD_WEBHOOK_URL)
  4. 4Répéter l'opération pour les webhooks de statut (optionnels) et les ajouter aux variables correspondantes

déployer le tunnel Cloudflare

  1. 1Installer cloudflared via le script deploy-debian.sh
  2. 2Lancer la création du tunnel : cloudflared tunnel create plexit-tunnel
  3. 3Configurer le tunnel pour rediriger le port 3001 vers le service local
  4. 4Démarrer le tunnel avec : cloudflared tunnel run plexit-tunnel

gérer les demandes en tant qu'administrateur

  1. 1Se rendre sur l'URL du site et entrer le PIN admin
  2. 2Accéder à la section « Admin » du menu
  3. 3Voir la liste des demandes en attente
  4. 4Utiliser les boutons « Approuver », « Refuser » ou « Rappeler » pour chaque demande
  5. 5Vérifier que le webhook Discord correspondant s’est déclenché

installer l'application en tant que PWA

  1. 1Ouvrir le site PleXIT dans un navigateur compatible (Chrome, Edge, Firefox)
  2. 2Cliquer sur l’icône d’installation (généralement dans la barre d’adresse)
  3. 3Confirmer l’ajout à l’écran d’accueil ou au bureau
  4. 4Accepter les notifications push lorsqu’elles sont demandées

mettre à jour PleXIT

  1. 1Se placer dans le répertoire du projet : cd /home/user/plexit
  2. 2Récupérer les dernières modifications : git pull
  3. 3Re‑exécuter le script de mise à jour : bash update-debian.sh
  4. 4Redémarrer le service PM2 si nécessaire : pm2 restart plexit

Astuces

  • Utilisez un token Plex dédié avec des permissions limitées pour plus de sécurité.
  • Conservez le PIN admin dans un gestionnaire de mots de passe, il n’est pas stocké dans le code.
  • Pour éviter les spams, limitez les webhooks Discord aux salons privés réservés aux membres.

Questions fréquentes

Comment récupérer le token Plex si je ne le trouve pas dans l'URL XML ?

Activez l’option « Afficher les informations avancées » dans les paramètres Plex, puis cliquez sur « Copier le token » depuis la page de gestion du compte.

Que faire si le tunnel Cloudflare ne démarre pas ?

Vérifiez que le port 3001 n’est pas bloqué par le firewall, puis relancez cloudflared avec les droits sudo.

Puis‑je héberger PleXIT sur Windows ?

Le script d’installation fourni ne supporte que Linux ; sous Windows il faut installer manuellement Node.js, PM2 et configurer un reverse‑proxy.

Tutoriel rédigé automatiquement à partir de la documentation du projet, mis à jour à chaque évolution.