Skip to content

Setting Up FreshRSS with Docker Compose

Introduction to FreshRSS

FreshRSS is a self-hosted RSS feed aggregator. It is lightweight, easy to work with, and allows you to keep all your favorite news feeds and blogs organized in one place.

Docker Compose Configuration for FreshRSS

This Docker Compose setup deploys FreshRSS in a Docker container, providing an isolated and efficient environment for managing your RSS feeds.

Docker Compose File (docker-compose.yml)

version: "2.1"
    container_name: freshrss
      - PUID=1000
      - PGID=1000
      - TZ=Etc/UTC
      - /path/to/data:/config 
      - 80:80 
    restart: unless-stopped

Key Components of the Configuration

Environment Variables

  • PUID=1000 and PGID=1000: Set user and group IDs for file permissions.
  • TZ=Etc/UTC: Sets the container's timezone.


  • /path/to/data:/config: Maps the local data directory to the container's configuration directory.


  • 80:80: Maps port 80 of the host to port 80 of the container, allowing web access to FreshRSS.

Restart Policy

  • unless-stopped: Ensures the container restarts automatically unless explicitly stopped.

Deploying FreshRSS

  1. Save the Docker Compose configuration in a docker-compose.yml file.
  2. Replace /path/to/data with your desired local directory path.
  3. Run docker-compose up -d to start FreshRSS in detached mode.
  4. Access FreshRSS via http://<host-ip>.

Configuring and Using FreshRSS

After deployment, access the FreshRSS web interface to configure your feeds, categories, and reading preferences. Ensure you manage user accounts and settings as required.

Youtube Video