neingeist/ttrss-docker-compose
1
0
Fork 0
mirror of https://git.tt-rss.org/fox/ttrss-docker-compose synced 2025-11-04 09:34:13 +01:00
Code Issues Releases Wiki Activity
Dockerized tt-rss using docker-compose
14 commits 8 branches 0 tags 610 KiB
Find a file
Andrew Dolgov c9a6cb65e9 update README
2019-11-15 21:34:23 +03:00
app add index.php redirecting to /tt-rss/ 2019-11-15 21:18:49 +03:00
web various updates 2019-11-15 17:42:50 +03:00
.env enable nginx_xaccel, etc 2019-11-15 17:54:33 +03:00
docker-compose.yml rename app volume 2019-11-15 21:20:27 +03:00
README.md update README 2019-11-15 21:34:23 +03:00

README.md

A primitive set of scripts to deploy tt-rss via docker-compose

EXPERIMENTAL STUFF, DON'T USE IN PRODUCTION

The idea is to provide tt-rss working (and updating) out of the box with minimal fuss.

The general outline of the configuration is as follows:

  • three linked containers (frontend: nginx, database: pgsql, application: php/fpm)
  • nginx has its http port exposed to the outside
  • feed updating is done via embedded cron job, every 15 minutes
  • tt-rss source updates from git master repository on container restart
  • schema is installed automatically if it is missing
  • config.php is generated if it is missing
  • SSL termination not included, use a sidecar container for that (TODO)
  • tt-rss code is stored on a persistent volume so plugins, etc. could be easily added

Post your feedback here:

https://community.tt-rss.org/t/docker-compose-tt-rss/2894

Installation

  1. Check out scripts from Git:
git clone https://git.tt-rss.org/fox/ttrss-docker-compose.git ttrss-docker
  1. Edit .env and/or docker-compose.yml if necessary

You will probably have to edit SELF_URL_PATH which should equal fully qualified tt-rss URL as seen when opening it in your web browser. If this field is set incorrectly, you will likely see the correct value in the tt-rss fatal error message.

  1. Run the container:
cd ttrss-docker && docker-compose up

See docker-compose documentation for more information and available options.

Updating

Restarting the container will update the source from origin repository.

How do I add plugins and themes?

By default, tt-rss code is stored on a persistent docker volume (app). You can find its location like this:

docker volume inspect ttrss-docker_app | grep Mountpoint

Alternatively, you can mount any host directory as /var/www/html by updating docker-compose.yml, i.e.:

volumes:
      - app:/var/www/html

Replace with:

volumes:
      - /opt/tt-rss:/var/www/html

Copy and/or git clone any third party plugins into plugins.local as usual.

TODO

  • support for sending mail somehow (smtp mailer?)
  • properly deal with SELF_URL_PATH

Feedback / suggestions2

Forum thread