freshrss/edge/docs/fr/users

01_Installation
Edited: Tuesday 15 September 2026

Les pré-requis sur le serveur

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

Choisir la bonne version de FreshRSS

FreshRSS possède deux canaux de distributions (ou branches) qui sortent à des fréquences plus ou moins rapides:

Canal de publication continue

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.

Canal de publication versionnée

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.

Installation sur Apache

 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>

Installation sur Nginx

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}

Conseils de sécurité

TODO