{"id":13841745,"url":"https://github.com/nVentiveUX/docker-ttrss","last_synced_at":"2025-07-11T13:32:14.128Z","repository":{"id":40791838,"uuid":"118192538","full_name":"nVentiveUX/docker-ttrss","owner":"nVentiveUX","description":"A multiarch docker image for Tiny Tiny RSS feed reader","archived":false,"fork":false,"pushed_at":"2024-09-14T08:18:02.000Z","size":187,"stargazers_count":18,"open_issues_count":1,"forks_count":6,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-09-14T19:26:14.431Z","etag":null,"topics":["arm","docker","raspberrypi","rss","rss-aggregator","tiny-tiny-rss","tt-rss"],"latest_commit_sha":null,"homepage":"https://hub.docker.com/r/nventiveux/ttrss/","language":"Dockerfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nVentiveUX.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-01-20T00:11:13.000Z","updated_at":"2024-09-14T08:18:06.000Z","dependencies_parsed_at":"2023-01-31T18:30:33.579Z","dependency_job_id":"25ace8ae-d036-4bf1-9946-3f5e5c989351","html_url":"https://github.com/nVentiveUX/docker-ttrss","commit_stats":null,"previous_names":[],"tags_count":89,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nVentiveUX%2Fdocker-ttrss","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nVentiveUX%2Fdocker-ttrss/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nVentiveUX%2Fdocker-ttrss/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nVentiveUX%2Fdocker-ttrss/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nVentiveUX","download_url":"https://codeload.github.com/nVentiveUX/docker-ttrss/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225729648,"owners_count":17515149,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["arm","docker","raspberrypi","rss","rss-aggregator","tiny-tiny-rss","tt-rss"],"created_at":"2024-08-04T17:01:20.059Z","updated_at":"2024-11-21T12:30:21.475Z","avatar_url":"https://github.com/nVentiveUX.png","language":"Dockerfile","funding_links":[],"categories":["PHP","PHP (184)","Dockerfile"],"sub_categories":[],"readme":"# Tiny Tiny RSS docker image\n\n[![Release](https://github.com/nVentiveUX/docker-ttrss/actions/workflows/release.yaml/badge.svg)](https://github.com/nVentiveUX/docker-ttrss/actions/workflows/release.yaml)\n\nHost [Tiny Tiny RSS](https://tt-rss.org/) instance in a docker container supporting amd64, arm64 and arm architectures (RaspberryPi).\n\n* [Available images and tags](#available-images-and-tags)\n* [Features](#features)\n* [Configuration](#configuration)\n* [Usage](#usage)\n  * [Prepare the database](#prepare-the-database)\n  * [Run TTRSS instance](#run-ttrss-instance)\n* [Tests and development](#tests-and-development)\n* [Maintenance](#maintenance)\n  * [Restoring a PostgreSQL database](#restoring-a-postgresql-database)\n\n## Available images and tags\n\nThe following multi-architecture image is available:\n\n* **[nventiveux/ttrss](https://hub.docker.com/r/nventiveux/ttrss)**\n  * *latest* ([Dockerfile](https://github.com/nVentiveUX/docker-ttrss/blob/master/Dockerfile))\n  * [See all tags](https://hub.docker.com/r/nventiveux/ttrss/tags?page=1\u0026ordering=last_updated)\n\n**Hint**: tags are following [calver versionning](https://calver.org/) with pattern `vYYYY.MM.DD`.\n\n## Features\n\nSome additionnals features are added to the base installation of TT-RSS:\n\n* [Feedly](https://github.com/levito/tt-rss-feedly-theme) theme.\n* [Mercury Fulltext](https://github.com/HenryQW/mercury_fulltext) plugin installed (you need to [configure and enable it](https://github.com/HenryQW/mercury_fulltext#installation) before).\n\n## Configuration\n\nWe are now using configuration through environment variables from upstream project. Refer to [this documentation](https://tt-rss.org/wiki/GlobalConfig).\n\n## Usage\n\nCreate a network:\n\n```sh\ndocker network create ttrss_net\n```\n\n### Prepare the database\n\nYou have 2 choices: **postgresql** or **mysql** database.\n\nCreate a **postgresql** database:\n\n```sh\ndocker run \\\n  -d \\\n  --name ttrss_database \\\n  -v ttrss_db_vol:/var/lib/postgresql/data \\\n  -e POSTGRES_USER=ttrss \\\n  -e POSTGRES_PASSWORD=ttrss \\\n  --network ttrss_net \\\n  postgres:12.6-alpine\n```\n\nCreate a **mysql** database:\n\n```sh\ndocker run \\\n  -d \\\n  --name ttrss_database \\\n  -v ttrss_db_vol:/var/lib/mysql \\\n  -e MYSQL_DATABASE=ttrss \\\n  -e MYSQL_USER=ttrss \\\n  -e MYSQL_PASSWORD=ttrss \\\n  -e MYSQL_ROOT_PASSWORD=ttrssroot \\\n  --network ttrss_net \\\n  mysql:8.0.23\n```\n\n### Run TTRSS instance\n\nRun **ttrss** instance (adapt `TTRSS_DB_TYPE` to `mysql` if database is MySQL / MariaDB):\n\n```sh\ndocker run \\\n  -d \\\n  --name ttrss \\\n  -e TTRSS_DB_HOST=\"ttrss_database\" \\\n  -e TTRSS_DB_TYPE=\"pgsql\" \\\n  -p 8000:80 \\\n  --network ttrss_net \\\n  nventiveux/ttrss:latest\n```\n\nOpen browser to [http://localhost:8000/](http://localhost:8000/). Login as **admin** with password **password**.\n\n## Tests and development\n\nAdapt the `Dockerfile` to your needs.\n\nThen test the image locally:\n\n```sh\n# PostgresSQL\ncd tests/ttrss-pgsql \u0026\u0026 docker-compose up --build\n\n# MySQL\ncd tests/ttrss-mysql \u0026\u0026 docker-compose up --build\n```\n\nOpen browser to [http://localhost:8000/](http://localhost:8000/). Login as **admin** with password **password**.\n\n## Maintenance\n\n### Restoring a PostgreSQL database\n\n```sh\n# Using docker\ndocker exec -i \u003cdatabase_container_id\u003e \\\n  pg_restore \\\n    --no-acl \\\n    --no-owner \\\n    -U ttrss \\\n    -d ttrss \u003c \u003cpgdump_filename\u003e\n\n# Using docker-compose\ndocker-compose exec -T database \\\n  pg_restore \\\n    --no-acl \\\n    --no-owner \\\n    -U ttrss \\\n    -d ttrss \u003c /home/vbesancon/tmp/db_ttrss_1615503601.pgdump\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FnVentiveUX%2Fdocker-ttrss","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FnVentiveUX%2Fdocker-ttrss","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FnVentiveUX%2Fdocker-ttrss/lists"}