=> 🏡 Home | Back to notes

FreshRSS

Last updated on 28 September 2022

For managing and consuming RSS feeds, I use FreshRSS [1].

=> 1

To run a FreshRSS instance, create a docker-compose.yml file:

version: "3"

services:
  freshrss:
    image: freshrss/freshrss
    environment:
      - "CRON_MIN=3,33" # Change this if you like
      - TZ=Europe/London
    volumes:
      - ./freshrss_data:/var/www/FreshRSS/data
      - ./freshrss_extensions:/var/www/FreshRSS/extensions
    restart: unless-stopped
    ports:
      - 8081:80

I run FreshRSS within my Tailscale network and so I do not bother with TLS certificates or a reverse proxy. If you do want to use one, look at the Traefik [2] note.

=> 2

Administration

Once up, visit the service using your web browser to setup an admin account and configure the settings as needed.

Themes

To add additional themes beyond which that ship with the default setup, create a new themes directory and clone the repo into that directory.

Then, mount the new theme directory in your FreshRSS docker-compose.yml in the volumes block. For example, for Joel's [3] Nord Theme [4]:

=> 3 | 4

  ...
  volumes:
    ...
    - ./themes/freshrss-nord-theme/:/var/www/FreshRSS/p/themes/freshrss-nord-theme/

Take the service down and bring it back up again, and then the theme will be available in the FreshRSS settings.

Clients

I use the Reeder app, which has built-in support for FreshRSS. Simply provide the address to the FreshRSS server - along with your username and password - and it'll handle the rest.

=> Back to notes