You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
lunik1 7b14383eb1
Add deprecation notice
4 months ago
root Add deprecation notice 4 months ago
.dockerignore add .ignores and templates 5 years ago
.gitattributes add .ignores and templates 5 years ago
.gitignore add .ignores and templates 5 years ago
Dockerfile Update nginx to 3.13 5 months ago
Dockerfile.aarch64 Update nginx to 3.13 5 months ago
Dockerfile.armhf Update nginx to 3.13 5 months ago
LICENSE Bot Updating Templated Files 2 years ago Add deprecation notice 4 months ago


This repository has been deprecated, development continues at

The container image is now hosted at

Original README

A fork of the deprecated tt-rss container. Uses latest master of tt-rss when built and rebuilds are triggered when commits are added to the tt-rss master branch or the base container is updated.

Find the Image on Docker Hub:

NOT supported or endorsed by the team.



docker create \
  --name=tt-rss \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Europe/London \
  -p 80:80 \
  -v <path to data>:/config \
  --restart unless-stopped \


Compatible with docker-compose v2 schemas.

version: "2"
    image: lunik1/tt-rss
    container_name: tt-rss
      - PUID=1000
      - PGID=1000
      - TZ=Europe/London
      - <path to data>:/config
      - 80:80
    restart: unless-stopped


Parameter Function
-p 80 WebUI
-e PUID=1000 for UserID
-e PGID=1000 for GroupID
-e TZ=Europe/London Specify a timezone to use EG Europe/London.
-v /config Where tt-rss should store it's config files and data.

Environment variables from files (Docker secrets)

You can set any environment variable from a file by using a special prepend FILE__.

As an example:

-e FILE__PASSWORD=/run/secrets/mysecretpassword

Will set the environment variable PASSWORD based on the contents of the /run/secrets/mysecretpassword file.


Application Setup

You must create a user and database for tt-rss to use in a mysql/mariadb or postgresql server. A basic nginx configuration file can be found in /config/nginx/site-confs , edit the file to enable ssl (port 443 by default), set servername etc.. Self-signed keys are generated the first time you run the container and can be found in /config/keys , if needed, you can replace them with your own.

The default username and password after initial configuration is admin/password

Application Configuration

The container can configure itself using environment variables, this is now preferred over using config.php. The most common variables to set are a URL for the application and a database endpoint. IE:

  • -e TTRSS_DB_TYPE=mysql
  • -e TTRSS_DB_HOST=host
  • -e TTRSS_DB_USER=user
  • -e TTRSS_DB_NAME=name
  • -e TTRSS_DB_PASS=password
  • -e TTRSS_DB_PORT=3306
  • -e TTRSS_SELF_URL_PATH=http://localhost/

For a full list of supported variables and their defaults see here.

Please note you need to have an already initialized database endpoint.