Dans cette documentation nous installerons le logiciel TTRSS avec Docker.

Pour mieux s'y retrouver cette documentation disposera de plusieurs screenshots illustrant les consignes.

Tiny Tiny RSS (souvent abrégé en TTRSS) est un lecteur et agrégateur RSS/ATOM

Accessible ensuite depuis n'importe quel navigateur, il permet de s'abonner aux flux RSS ou ATOM des sites que vous souhaitez suivre afin de recevoir les derniers articles publiés. Une application officielle android est également disponible.

Il propose de nombreux fonctionnalités telles que l'import / export OPML, le partage via RSS ou réseaux sociaux, l'ajout de plugins ou de thèmes, le support des podcasts, le filtrage des flux RSS, etc.

Nous considérons que vous êtes équipé de cette manière :

1. Une VM sous Debian avec docker à installer [node03]

Les allocations de matériel (CPU/RAM…) sont à allouer selon vos envies, attention à respecter la configuration minimale. C'est à dire :

Pour TTRSS :

1. 512MB de ram
2. 1 cœurs de CPU
3. 8GB d'espace disque
4. Debian 11
5. PHP 7.4
6. Docker

Nos IP pour notre infrastructure seront :

1. [TTRSS] : 10.192.100.123

Mot de passe par défaut sur toutes les sessions : Not24get

Rappel des deux commandes essentiels :

1. ip a (connaitre son adresse IP)
2. nano /etc/network/interfaces (configuration de l'interface réseau)

Conseil : Ajouter les deux machines dans un logiciel tel que mRemoteNG pour faciliter l'administration.

• Ajouter les paquets pour installer des paquets depuis des sources sécurisées

snippet.bash

apt-get install \
    ca-certificates \
    curl \
    gnupg

• Ajouter la clé GPG de Docker

mkdir -m 0755 -p /etc/apt/keyrings

snippet.bash

curl -fsSL https://download.docker.com/linux/debian/gpg | gpg --dearmor -o /etc/apt/keyrings/docker.gpg

• Ajouter le repo dans le sources.list

snippet.bash

echo \
  "deb [arch="$(dpkg --print-architecture)" signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/debian \
  "$(. /etc/os-release && echo "$VERSION_CODENAME")" stable" | \
  tee /etc/apt/sources.list.d/docker.list > /dev/null

• Mettre à jour le nouveau dépôt

apt-get update

• Installation de Docker et de ses dépendances

snippet.bash

apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Cette commande télécharge une image de test et l'exécute dans un conteneur. Lorsque le conteneur s'exécute, il imprime un message de confirmation et se ferme.

docker run hello-world

Cette image embarque un serveur web sous base nginx et un serveur SQL.

• Cloner le repo Github de ttrss

git clone https://git.tt-rss.org/fox/ttrss-docker-compose.git ttrss-docker

cd ttrss-docker

• Changer de branche vers static-dockerhub

git checkout static-dockerhub

• Configuration de l'environnement

mv .env-dist .env
nano .env

Modifier le fichier selon votre volonté

• Télécharger et démarrer le container

docker compose pull && docker compose up -d

Visiter la page : http://<IP>:8280/tt-rss

A partir d'un autre serveur nginx.

• Créer une entrée A dans votre serveur DNS qui point vers l'ip de votre serveur
  • Exemple :

ttrss.stoneset.fr.         IN      A       10.192.100.209

• Créer la configuration dans les sites-available :

nano /etc/nginx/sites-available/proxy_ttrss.conf

snippet.yaml

server {
    server_name ttrss.stoneset.fr;
    location / {
        proxy_pass http://node03.local:8280;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_cache_bypass $http_upgrade;
    }
}

• Redémarrer nginx :

systemctl restart nginx

• Changer le mot de passe par défaut

Une fois les flux ajoutés :

• Liste de flux well-known RSS :
  • https://www.anandtech.com/rss
  • https://www.it-connect.fr/feed/
  • https://rdr-it.com/feed/
  • https://www.lesnumeriques.com/rss.xml
  • https://www.zdnet.fr/feeds/rss/actualites/
  • https://www.01net.com/actualites/feed/
  • https://www.lemondeinformatique.fr/flux-rss/thematique/telecom/rss.xml

1. https://framalibre.org/content/tiny-tiny-rss
2. https://tt-rss.org/wiki/InstallationNotes
3. https://docs.docker.com/engine/install/debian/