tt-rss

tt-rss

Docker app from A75G's Repository

Overview

A fork of the deprecated linuxserver.io tt-rss container. The default username and password after initial configuration is admin/password

DEPRECATION NOTICE

This repository has been deprecated, development continues at https://gitlab.com/lunik1/docker-tt-rss.

The container image is now hosted at registry.gitlab.com/lunik1/docker-tt-rss.

Original README

A fork of the deprecated linuxserver.io 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: https://hub.docker.com/r/lunik1/tt-rss

NOT supported or endorsed by the linuxserver.io team.

Usage

docker

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 \
  lunik1/tt-rss

docker-compose

Compatible with docker-compose v2 schemas.

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

Parameters

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.

Install tt-rss on Unraid in a few clicks.

Find tt-rss in Community Apps on your Unraid server, review the template, and click Install. Unraid handles the Docker app or plugin setup from the published template.

Open the Apps tab on your Unraid server Search Community Apps for tt-rss Review the template variables and paths Click Install

Download Statistics

1,294,541
Total Downloads
43
This Month
73
Avg / Month

Total Downloads Over Time

Loading chart...

Related apps

Explore more like this

Explore all

Details

Repository
lunik1/tt-rss:latest
Last Updated2021-07-28
First Seen2020-08-06

Runtime arguments

Web UI
http://[IP]:[PORT:80]/
Network
bridge
Shell
sh
Privileged
false

Template configuration

PortPorttcp

Port

Target
80
Default
8000
Value
8000
AppDataPathrw

AppData

Target
/config
Default
/mnt/user/appdata/tt-rss/
Value
/mnt/user/appdata/tt-rss
TTRSS_DB_TYPEVariable

TTRSS_DB_TYPE

Default
mysql
Value
mysql
TTRSS_DB_HOSTVariable

Database IP (Change it)

Default
192.168.0.100
Value
192.168.0.100
TTRSS_DB_USERVariable

TTRSS_DB_USER

Default
root
Value
root
TTRSS_DB_NAMEVariable

TTRSS_DB_NAME

Default
tt-rss
Value
tt-rss
TTRSS_DB_PASSVariable

TTRSS_DB_PASS

Default
dbpassword
Value
dbpassword
TTRSS_DB_PORTVariable

TTRSS_DB_PORT

Default
3306
Value
3306
TTRSS_SELF_URL_PATHVariable

TTRSS_SELF_URL_PATH

Default
http://192.168.0.100:8000/
Value
http://192.168.0.100:8000/
PUIDVariable

PUID

Default
99
Value
99
PGIDVariable

PGID

Default
100
Value
100