Sign inSign up

nventiveux/ttrss

By nventiveux

•Updated 6 days ago

Multi-architecture image for Tiny Tiny RSS (amd64 / arm)

Image
2

100K+

nventiveux/ttrss repository overview

⁠Tiny Tiny RSS docker image

Important

The author of TT-RSS has announced the shutdown of all infrastructure related to the project ([announcement](https://community.tt-rss.org/t/the-end-of-tt-rss-org/7164)). To ensure continued functionality, I’ve migrated the image build process to target the official fork at [tt-rss/tt-rss](https://github.com/tt-rss/tt-rss). This change maintains operational stability while preserving the project’s utility for the community <3.

I’ve transitioned to FreshRSS⁠ over the past few years. This project is now in maintenance mode. While I will no longer implement new features, I remain committed to:

  • Reviewing pull requests
  • Addressing minor bugs
  • Supporting the community

Merci beaucoup 💪

Release

Host Tiny Tiny RSS⁠ instance in a docker container supporting amd64, arm64 and arm architectures (RaspberryPi).

⁠Available images and tags

The following multi-architecture image is available:

Hint: tags are following calver versionning⁠ with pattern vYYYY.MM.DD.

⁠Features

Some additionnals features are added to the base installation of TT-RSS:

⁠Configuration

We are now using configuration through environment variables from upstream project. Refer to this documentation⁠.

⁠Usage

Create a network:

docker network create ttrss_net
⁠Prepare the database

You have 2 choices: postgresql or mysql database.

Create a postgresql database:

docker run \
  -d \
  --name ttrss_database \
  -v ttrss_db_vol:/var/lib/postgresql/data \
  -e POSTGRES_USER=ttrss \
  -e POSTGRES_PASSWORD=ttrss \
  --network ttrss_net \
  postgres:12.6-alpine

Create a mysql database:

docker run \
  -d \
  --name ttrss_database \
  -v ttrss_db_vol:/var/lib/mysql \
  -e MYSQL_DATABASE=ttrss \
  -e MYSQL_USER=ttrss \
  -e MYSQL_PASSWORD=ttrss \
  -e MYSQL_ROOT_PASSWORD=ttrssroot \
  --network ttrss_net \
  mysql:8.0.23
⁠Run TTRSS instance

Run ttrss instance (adapt TTRSS_DB_TYPE to mysql if database is MySQL / MariaDB):

docker run \
  -d \
  --name ttrss \
  -e TTRSS_DB_HOST="ttrss_database" \
  -e TTRSS_DB_TYPE="pgsql" \
  -p 8000:80 \
  --network ttrss_net \
  nventiveux/ttrss:latest

Open browser to http://localhost:8000/⁠. Login as admin with password password.

⁠Tests and development

Adapt the Dockerfile to your needs.

Then test the image locally:

# PostgresSQL
cd tests/ttrss-pgsql && docker-compose up --build

# MySQL
cd tests/ttrss-mysql && docker-compose up --build

Open browser to http://localhost:8000/⁠. Login as admin with password password.

⁠Maintenance

⁠Restoring a PostgreSQL database
# Using docker
docker exec -i <database_container_id> \
  pg_restore \
    --no-acl \
    --no-owner \
    -U ttrss \
    -d ttrss < <pgdump_filename>

# Using docker-compose
docker-compose exec -T database \
  pg_restore \
    --no-acl \
    --no-owner \
    -U ttrss \
    -d ttrss < /home/vbesancon/tmp/db_ttrss_1615503601.pgdump

Tag summary

Content type

Image

Digest

sha256:927c36726…

Size

64.9 MB

Last updated

6 days ago

docker pull nventiveux/ttrss