FreshRSS

A free, self-hostable news aggregator

Alternative to: feedly, inoreader, newsblur

FreshRSS is a self-hosted RSS and Atom feed aggregator. It is lightweight, multi-user with an anonymous reading mode, and supports custom tags, WebSub push notifications, and web scraping via XPath for sites without a feed. An API is available for mobile clients, and it supports OpenID Connect and HTTP authentication.

FreshRSS Docker Compose example

Self-host FreshRSS on your own server, homelab, or VPS starting from this Docker Compose example. It runs FreshRSS in Docker containers using the official freshrss/freshrss:latest image, with persistent volumes and automatic restarts preconfigured. Review the environment variables and adjust them to your setup, save the file as compose.yml (or docker-compose.yml), and start the stack with docker compose up -d.

services:
  freshrss:
    image: freshrss/freshrss:latest
    restart: unless-stopped
    logging:
      options:
        max-size: "10m"
    volumes:
      - data:/var/www/FreshRSS/data
      - extensions:/var/www/FreshRSS/extensions
    environment:
      # A server timezone, see http://php.net/timezones
      TZ: "UTC"
      # Minutes for the built-in cron job that auto-refreshes feeds (e.g. "1,31"). Leave empty to disable.
      CRON_MIN: "1,31"
    healthcheck:
      test: ["CMD", "cli/health.php"]
      timeout: 10s
      start_period: 60s
      start_interval: 11s
      interval: 75s
      retries: 3

volumes:
  data:
  extensions:

Prefer a managed setup? WinterFlow installs, configures, and updates FreshRSS for you using this same Docker Compose configuration.