freshrss/edge/docs/fr/users
01_Installation| modified | Tuesday 15 September 2026 |
|---|
FreshRSS est un logiciel développé en PHP reposant sur le modèle client - serveur. C’est-à-dire qu’il vous faudra un serveur web pour en profiter. Ensuite, FreshRSS ne demande pas une configuration très fournie et peut donc, en théorie, tourner sur la plupart des serveurs mutualisés.
Il est toutefois de votre responsabilité de vérifier que votre hébergement permettra de faire tourner FreshRSS avant de nous taper dessus. Dans le cas où les informations listées ci-dessous ne seraient pas à jour, vous pourrez.
| Logiciel | Recommandé | Fonctionne aussi avec |
|---|---|---|
| Serveur web | Apache 2.4+ | nginx, lighttpd |
| PHP | PHP 8.1+ | FreshRSS 1.24.3 : PHP 7.4+ FreshRSS 1.22.1 : PHP 7.2+ |
| Modules PHP | Requis : libxml, cURL, JSON, PDO_MySQL, PCRE et ctype Requis (32 bits seulement) : GMP Recommandé : Zlib, mbstring et iconv, ZipArchive Pour une liste complète des modules nécessaires voir le Dockerfile |
|
| Base de données | PostgreSQL 10+ | SQLite, MariaDB 10.6+, MySQL 8.0+ |
| Navigateur | Firefox | Chrome, Opera, Safari, or Edge |
FreshRSS possède deux canaux de distributions (ou branches) qui sortent à des fréquences plus ou moins rapides:
Si vous voulez une publication continue (rolling release) avec les dernières nouveautés et sécurité,
ou bien aider à tester ou développer la future version,
vous pouvez utiliser la branche edge.
Si vous préférez moins de mises à jour, vous pouvez utiliser la branche latest.
Celle-ci est plus stable mais au prix de moins de sécurité et de plus de bugs connus
car les corrections ne sont pas rétro-portées sur les anciennes versions.
De nouvelles versions sont publiées quelques fois par an.
Voir la dernière version
et la liste des versions.
1<VirtualHost *:80>
2 DocumentRoot /var/www/html/
3
4 #Site par défaut...
5
6 ErrorLog ${APACHE_LOG_DIR}/error.default.log
7 CustomLog ${APACHE_LOG_DIR}/access.default.log vhost_combined
8</VirtualHost>
9
10<VirtualHost *:80>
11 ServerName rss.example.net
12 DocumentRoot /path/to/FreshRSS/p/
13
14 <Directory /path/to/FreshRSS/p>
15 AllowOverride AuthConfig FileInfo Indexes Limit
16 Require all granted
17 </Directory>
18
19 ErrorLog ${APACHE_LOG_DIR}/freshrss_error.log
20 CustomLog ${APACHE_LOG_DIR}/freshrss_access.log combined
21
22 AllowEncodedSlashes On
23</VirtualHost>
24
25<IfModule mod_ssl.c>
26 <VirtualHost *:443>
27 ServerName rss.example.net
28 DocumentRoot /path/to/FreshRSS/p/
29
30 <Directory /path/to/FreshRSS/p>
31 AllowOverride AuthConfig FileInfo Indexes Limit
32 Require all granted
33 </Directory>
34
35 ErrorLog ${APACHE_LOG_DIR}/freshrss_error.log
36 CustomLog ${APACHE_LOG_DIR}/freshrss_access.log combined
37
38 <IfModule mod_http2.c>
39 Protocols h2 http/1.1
40 </IfModule>
41
42 # Pour l’API
43 AllowEncodedSlashes On
44
45 SSLEngine on
46 SSLCompression off
47 SSLCertificateFile /path/to/server.crt
48 SSLCertificateKeyFile /path/to/server.key
49 # Additional SSL configuration, e.g. with LetsEncrypt
50 </VirtualHost>
51</IfModule>
Voici un fichier de configuration pour nginx. Il couvre la configuration pour HTTP, HTTPS, et PHP.
Vous pourrez trouver d’autres fichiers de configuration plus simples mais ces derniers ne seront peut-être pas compatibles avec l’API FreshRSS.
1server {
2 listen 80;
3 listen 443 ssl;
4
5 # configuration https
6 ssl on;
7 ssl_certificate /etc/nginx/server.crt;
8 ssl_certificate_key /etc/nginx/server.key;
9
10 # l’URL ou les URLs de votre serveur
11 server_name rss.example.net;
12
13 # le répertoire où se trouve le dossier p de FreshRSS
14 root /srv/FreshRSS/p/;
15
16 index index.php index.html index.htm;
17
18 # les fichiers de log nginx
19 access_log /var/log/nginx/rss.access.log;
20 error_log /var/log/nginx/rss.error.log;
21
22 # gestion des fichiers php
23 # il est nécessaire d’utiliser cette expression régulière pour le bon fonctionnement de l’API
24 location ~ ^.+?\.php(/.*)?$ {
25 fastcgi_pass unix:/var/run/php/php8.1-fpm.sock;
26 fastcgi_split_path_info ^(.+\.php)(/.*)$;
27 # Par défaut la variable PATH_INFO n’est pas définie sous PHP-FPM
28 # mais les APIs FreshRSS greader.php et misc.php en ont besoin. Si vous avez un “Bad Request”, vérifiez bien cette dernière !
29 # REMARQUE : l’utilisation de la variable $path_info est requis. Pour plus de détails, voir :
30 # https://trac.nginx.org/nginx/ticket/321
31 set $path_info $fastcgi_path_info;
32 fastcgi_param PATH_INFO $path_info;
33 include fastcgi_params;
34 fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
35 }
36
37 location / {
38 try_files $uri $uri/ index.php;
39 }
40}
TODO