Préparez FreshRSS, installez FriRSS, puis reliez les deux. Ce guide vous accompagne jusqu’à votre première lecture.
FriRSS affiche les articles de votre instance FreshRSS. Avant de commencer, préparez ces trois éléments.
Gardez son adresse et votre nom d’utilisateur à portée de main.
Dans FreshRSS : Configuration → Authentification → Autoriser l’accès par API.
Définissez-le dans FreshRSS : Configuration → Profil. Il servira à connecter FriRSS.
Choisissez votre méthode. Les étapes de création du compte et de connexion à FreshRSS sont les mêmes ensuite.
Lancez l’image officielle. Le port 8080 de l’hôte correspond au port 80 du conteneur ; /app/data conserve la base de données et les clés de chiffrement.
mkdir -p frirss-data
docker run -d --name frirss \
--restart unless-stopped \
-p 8080:80 \
-v "$PWD/frirss-data:/app/data" \
-e TZ=Europe/Zurich \
ghcr.io/fripix/frirss:latestEnregistrez ce contenu dans compose.yaml, dans un dossier vide, puis lancez les commandes ci-dessous. Conservez le dossier frirss-data : il contient les données de votre instance.
services:
frirss:
image: ghcr.io/fripix/frirss:latest
container_name: frirss
ports:
- "8080:80"
volumes:
- ./frirss-data:/app/data
restart: unless-stopped
environment:
TZ: Europe/Zurich
# Facultatif : retirez le # devant une ligne pour l’activer (voir le tableau).
# Démarrage
# PUID: "1000"
# PGID: "1000"
# Réseau
# FRIRSS_BASE_URL: https://frirss.example.com
# PROXY_INTERNAL_HOSTS: 192.168.1.20
# PROXY_REWRITES: https://rss.example.com=http://freshrss:80
# CORS_ORIGIN: https://frirss.example.com
# Cache Redis, fortement recommandé
# REDIS_URL: redis://redis:6379
# CACHE_ARTICLES_PER_FEED: "50"
# CACHE_TTL: "86400"
# CACHE_SYNC_INTERVAL: "0"
# CACHE_SYNC_ACTIVE_DAYS: "7"
# CACHE_SYNC_PARALLEL_USERS: "3"
# Limites et stockage
# FRIRSS_REFRESH_MAX_FEEDS: "1000"
# FRIRSS_PROXY_RATE_LIMIT: "600"
# FRIRSS_DATA_DIR: /app/datamkdir -p frirss-data
docker compose up -dOuvrez l’onglet Apps d’Unraid Community Applications, recherchez FriRSS et installez son modèle. Vérifiez le port de l’hôte et le volume persistant /app/data avant le démarrage.
Ouvrir Community ApplicationsToutes sont facultatives, sauf TZ, déjà réglée. Dans compose.yaml, retirez le # devant une ligne pour l’activer ; avec docker run, ajoutez ‑e NOM=valeur avant le nom de l’image. Recréez ensuite le conteneur.
| Variable | À quoi elle sert | Par défaut |
|---|---|---|
| Démarrage | ||
TZ | Fuseau horaire du conteneur, pour les dates et les journaux. Exemple : Europe/Paris. | — |
PUID, PGID | Utilisateur et groupe qui font tourner FriRSS. Le dossier de données est repris à leur nom au démarrage. | 1000 |
| Réseau | ||
FRIRSS_BASE_URL | Adresse publique de FriRSS. Recommandée derrière un proxy inverse ; corrige aussi les adresses de retour de la connexion unique (OIDC). | Déduite de la requête |
PROXY_INTERNAL_HOSTS | Hôtes privés que FriRSS a le droit de joindre, séparés par des virgules. Nécessaire quand FreshRSS est sur votre réseau local ou un réseau Docker. | Aucun |
PROXY_REWRITES | Joindre FreshRSS par le réseau interne plutôt que par son adresse publique : adresse publique=adresse interne, séparées par des virgules. | Aucune |
CORS_ORIGIN | Origines autorisées, seulement si l’interface et le serveur sont servis séparément. | Aucune |
| Cache Redis, fortement recommandé | ||
REDIS_URL | Active le cache : listes affichées tout de suite, préchargement en arrière-plan, articles extraits et résultats IA partagés par toute l’instance. | Désactivé |
CACHE_ARTICLES_PER_FEED | Articles gardés en cache par flux. | 50 |
CACHE_TTL | Durée de vie d’une entrée du cache, en secondes. | 86400 (un jour) |
CACHE_SYNC_INTERVAL | Préchargement en arrière-plan, toutes les N minutes. 0 le coupe ; demande REDIS_URL. | 0 |
CACHE_SYNC_ACTIVE_DAYS | Ne précharge que pour les comptes vus ces N derniers jours. | 7 |
CACHE_SYNC_PARALLEL_USERS | Comptes préchargés en même temps. | 3 |
| Limites et stockage | ||
FRIRSS_REFRESH_MAX_FEEDS | Flux actualisés à chaque clic sur Actualiser. | 1000 |
FRIRSS_PROXY_RATE_LIMIT | Requêtes par compte et par minute, un seul budget pour le proxy, l’extraction d’articles et l’IA. 0 retire la limite. | 600 |
FRIRSS_DATA_DIR | Dossier de la base SQLite, dans le conteneur. | /app/data |
Une fois le conteneur démarré, ouvrez cette adresse sur l’hôte Docker, ou utilisez l’adresse de cet hôte depuis un autre appareil. Créez immédiatement le premier compte FriRSS : il devient administrateur. Les inscriptions se ferment ensuite et se réactivent dans Préférences → Administration.
http://localhost:8080Cette fois, utilisez les identifiants de FreshRSS. Ils sont distincts du compte FriRSS que vous venez de créer.
Ajouter un serveur FreshRSSConnectez votre instance FreshRSS pour commencer.URL du serveurhttps://rss.example.com
Utilisateur FreshRSSmaison
Mot de passe API••••••••••••Configuré dans FreshRSS → Configuration → Profil
Nom (optionnel)Maison
Connecter
Le proxy bloque les adresses privées par défaut. Autorisez explicitement le nom d’hôte ou l’IP de FreshRSS avec PROXY_INTERNAL_HOSTS. Remplacez l’adresse de l’exemple par la vôtre, sans désactiver globalement cette protection.
PROXY_INTERNAL_HOSTS=192.168.1.20Docker : ajoutez -e PROXY_INTERNAL_HOSTS=192.168.1.20 avant le nom de l’image. Compose : retirez le # devant la ligne PROXY_INTERNAL_HOSTS et remplacez l’adresse par celle de votre FreshRSS. Recréez le conteneur après modification.
Vos flux sont prêts à lire.Choisissez votre disposition, votre thème et votre premier article. Vous pourrez ensuite ajuster le reste à votre rythme.
FriRSS fonctionne avec sa base SQLite intégrée. Redis est un complément facultatif pour accélérer les lectures et partager le cache entre vos appareils.
FriRSS tourne sur votre serveur et ne garde que le nécessaire. Voici ce qu’il stocke, où, et ce qui sort de votre installation.
La clé qui chiffre les jetons est rangée dans la même base. Protégez et sauvegardez le dossier /app/data comme un mot de passe.
Lire la politique de sécuritéSauvegardez /app/data avec la procédure officielle d’instantané SQLite ou l’export chiffré. Copier uniquement un fichier frirss.db en cours d’utilisation n’est pas une sauvegarde fiable.
Pour l’accès distant, passez par un reverse proxy HTTPS ; n’exposez pas directement le port du conteneur à Internet. Pour les traductions IA, prévoyez des délais de lecture et d’envoi d’au moins 120 secondes.
Lisez les notes de version, sauvegardez les données, puis récupérez la nouvelle image et recréez le conteneur. Le README officiel reste la référence pour les évolutions de configuration.
Le README officiel reste la référence si une option ou une commande évolue.