Installer FreshRSS avec Docker

Introduction

FreshRSS est un agrégateur de flux rss léger libre. Il peut-être auto hébergé avec Docker. Ce type d’outil s’avère très utile quand on fait de la veille technologique ou pour suivre de toutes les nouveautés de nos sites préférés. Je l’utilise aussi pour surveiller simplement les mises à jour des images Docker hébergées sur mon NAS (j’utilisais watchtower auparavant pour surveiller mes containeurs).

Pour cette installation j’utilise l’image officielle qui est présente ici : https://github.com/FreshRSS/FreshRSS

Remarque : J’ai créé au préalable un utilisateur omdocker (voir l’article création d ‘un utilisateur Docker pour le détail). J’ai créé aussi un répertoire qui contiendra tous mes installations docker. dans ce blog, j’utiliserais pour exemple le chemin /volume/docker.

Nous allons créer aussi le répertoire freshrss en ligne de commande sur le NAS (connexion en SSH) dans notre répertoire docker : /volume/docker. Cette étape est facultative, le containeur créera le répertoire automatiquement lors du déploiement si celui ci n’existe pas.

$ cd /volume/docker
$ mkdir freshrss

Le fichier de configuration

Si vous souhaitez sécuriser le lancement de ‘freshrss‘, je vous engage à parcourir l’article securiser docker

Il est importent de bien respecter l’indentation des fichiers de configurations : pas de tabulation. Attention aussi à la version du fichier, il y a des légères évolutions de syntaxe d’une version à l’autre.

Le fichier yml en détails. Il faut remplacer pour votre configuration :

• port 8802 : numéro de port pour accéder à l’interface avec votre navigateur.
• PUID et PGID : celui de votre utilisateur Docker (omdocker pour ce blog),
• TZ : Votre zone de temps,

version: '3.3'
services:
  freshrss:
    container_name: freshrss
    image: freshrss/freshrss:latest
    environment:
       - PUID=1003
       - PGID=100
       - TZ=Europe/Paris
    ports:
       - 8802:80
    volumes:
       - /srv/disk1/docker/freshrss/data:/var/www/FreshRSS/data
       - /srv/disk1/docker/freshrss/extensions:/var/www/FreshRSS/extensions
    restart: on-failure:5
networks:
    default:
        external:
            name: mariadb_default

Vous copiez le contenu de ce fichier dans votre interface de gestion Portainer en allant dans ‘Stacks‘ et ‘Add stack‘.

Donnez un nom à votre pile, par exemple ‘freshrss‘, puis déployer cotre containeur en cliquant en bas sur « Deploy the stack‘.

Après une phase de téléchargement de l’image, puis d’installation de l’application, vous devriez arriver sur cet écran si tout s’est bien passé :

Nous pouvons maintenant nous connectez à ‘freshrss‘ avec l’URL : http://votreIP:8802.

Premier lancement

Nous choisissons la langue, puis il effectue une vérification de l’environnement :

Nous arrivons ensuite à l’étape de de connexion à la base de donnée. Il faut au préalable que vous ayez créer une base de données vide. Soit vous la créer via phpMyAdmin, soit en ligne de commande comme ceci en exécutant le containeur mariadb ( remplacer ‘Password‘ par votre mot de passe root):

$ docker exec -it mariadb mysql -uroot -pPassword
$ CREATE DATABASE freshrss;
$ exit

Si tout s’est bien passé, vous devriez arrivé au niveau du tableau de bord de ‘fresh RSS‘

L’interface et la configuration est assez intuitive. Vous pouvez créer vos catégories et étiquettes. Chaque syndication ajoutée peut-être relier à une catégorie. Voici un exemple de mon interface après avoir ajouter des catégories et quelques pages et sites que je surveille :