Tous les tutoriels
PureRSS-Web

Tutoriel

PureRSS-Web

Version 1.2.0 · Mis à jour le 8 octobre 2026

PureRSS‑Web est un agrégateur RSS auto‑hébergé qui centralise flux RSS, YouTube, réseaux sociaux et sites web. Le tutoriel explique comment préparer l’environnement, déployer l’application avec Docker et la configurer. Vous pourrez ensuite créer votre compte et commencer à ajouter des flux.

Ce qu'il faut

  • Docker ≥ 24.0 installé
  • Docker Compose ≥ 2.0 installé
  • OpenSSL disponible pour générer un secret JWT
  • Accès à un serveur (VPS ou machine locale) avec un domaine ou une adresse IP

Installation

Déploiement Docker

  1. 1Cloner le dépôt : `git clone https://github.com/Heiphaistos/PureRSS-AppWeb.git` puis `cd PureRSS-AppWeb`.
  2. 2Créer le fichier `.env` à la racine du projet en suivant le modèle fourni : définir `JWT_SECRET` (ex. `openssl rand -hex 32`) et `APP_URL` avec votre domaine ou IP.
  3. 3Optionnel : ajouter les variables SMTP si vous souhaitez activer la réinitialisation de mot de passe par email.
  4. 4Lancer les conteneurs : `docker compose up -d`.
  5. 5Vérifier le bon démarrage : `docker compose ps` doit afficher les services `purerss_nginx`, `purerss_frontend` et `purerss_backend` en état « running ».
  6. 6Configurer le DNS ou le fichier hosts pour que votre domaine pointe vers l’adresse IP du serveur.

Premier lancement

  1. 1Ouvrir votre navigateur et accéder à l’URL définie dans `APP_URL` (ex. https://votre-domaine.com).
  2. 2Cliquer sur « Créer un compte », saisir une adresse email et un mot de passe.
  3. 3Valider l’inscription ; le premier compte créé devient automatiquement administrateur.
  4. 4Se connecter avec les identifiants créés pour accéder au tableau de bord.

ajouter un flux RSS

Importez vos sources pour les lire dans l’interface.

  1. 1Dans le menu latéral, cliquer sur « Ajouter un flux ».
  2. 2Saisir l’URL du flux RSS ou Atom et choisir un groupe (ex. « RSS »).
  3. 3Définir l’intervalle de rafraîchissement souhaité (ex. 15 minutes).
  4. 4Enregistrer le flux ; il apparaîtra immédiatement dans la liste.

configurer un flux YouTube

Suivez les étapes pour suivre une chaîne YouTube via son flux RSS natif.

  1. 1Copier l’URL du flux RSS d’une chaîne : `https://www.youtube.com/feeds/videos.xml?channel_id=ID`.
  2. 2Créer un nouveau flux comme précédemment et coller l’URL.
  3. 3Sélectionner le groupe « YouTube » pour un affichage dédié.
  4. 4Enregistrer ; les vidéos apparaîtront comme articles.

personnaliser l’apparence

Choisissez parmi les 8 thèmes intégrés.

  1. 1Ouvrir la page « Paramètres » puis l’onglet « Thèmes ».
  2. 2Cliquer sur le thème souhaité ; le changement s’applique immédiatement.
  3. 3Le thème sélectionné est sauvegardé dans le localStorage du navigateur.

activer les notifications Discord

Recevez un message dans un canal Discord à chaque nouvel article.

  1. 1Créer un webhook Discord dans les paramètres du serveur.
  2. 2Dans PureRSS, ouvrir les paramètres du flux concerné et coller l’URL du webhook.
  3. 3Activer l’option « Notifier sur Discord ».
  4. 4Enregistrer ; les notifications seront envoyées automatiquement.

sauvegarder et restaurer les flux

Exportez votre configuration pour la réinstaller facilement.

  1. 1Dans la page « Paramètres », choisir l’onglet « Export/Import ».
  2. 2Cliquer sur « Exporter » pour télécharger un fichier JSON contenant tous les flux.
  3. 3Pour restaurer, cliquer sur « Importer » et sélectionner le fichier précédemment exporté.
  4. 4Confirmer l’import ; les flux sont recréés avec leurs paramètres.

mettre à jour PureRSS

Appliquez les nouvelles versions sans perdre les données.

  1. 1Se rendre dans le répertoire du projet et récupérer les dernières modifications : `git pull`.
  2. 2Recréer les images Docker : `docker compose build`.
  3. 3Redémarrer les conteneurs : `docker compose up -d`.
  4. 4Vérifier que la version affichée dans le pied de page a changé.

Astuces

  • Utilisez un certificat SSL gratuit avec Certbot pour sécuriser votre domaine.
  • Conservez le fichier `.env` hors du dépôt Git (ajoutez‑le à `.gitignore`).
  • Pour un rafraîchissement plus fréquent, augmentez la fréquence uniquement sur les flux critiques afin de limiter la charge serveur.

Questions fréquentes

Comment réinitialiser mon mot de passe si je l’ai oublié ?

Cliquez sur « Mot de passe oublié » sur la page de connexion, saisissez votre email et suivez le lien envoyé par le serveur (SMTP doit être configuré).

Puis‑je héberger PureRSS sans Docker ?

Oui, mais le README ne décrit que le déploiement Docker ; il faut alors installer manuellement Node.js, les dépendances et configurer Nginx.

Où sont stockées les données ?

Dans le fichier SQLite `purerss.db` situé dans le volume Docker `/opt/purerss/data/`.

Comment ajouter un nouveau thème ?

Copiez un fichier CSS dans le répertoire `frontend/src/themes/`, ajoutez‑le à la liste des thèmes dans le code Vue et redéployez le frontend.

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