Skip to content

christianhorn/ttrss-podman

Repository files navigation

Podmanized tt-rss

This is a podman version of tt-rss, https://tt-rss.org/ . The setup uses the same images as the official tt-rss build which is docker based. This file is also based on the docker-deployment.

Original docs: link.

Outline of the configuration:

  • separate containers (frontend: nginx, database: pgsql, app and updater: php/fpm)
  • images are pulled from Docker Hub
  • updates are not yet tested (the docker-ttrss deployment supports these)
  • nginx has its http port exposed to the outside
  • feed updates are handled via update daemon started in a separate container (updater)
  • optional backups container which performs tt-rss database backup once a week

Installation

To be executed as user:

git clone https://github.com/christianhorn/ttrss-podman
cd ttrss-podman
cp .env-dist .env
vi .env # details below

Edit configuration file

Configuration is done primarily through the .env file. Copy .env-dist to .env and edit any relevant variables you need changed.

  • Change ADMIN_USER_PASS to an initial admin user password. To the bare minimum, you need to set this.
  • Change TTRSS_SELF_URL_PATH to the fully qualified tt-rss URL you will use in your web browser. If this field is set incorrectly, you will likely see the correct value in the tt-rss fatal error message. The default is http://localhost:8280/tt-rss, so plain text access from your local hypervisor. That's appropriate for the default config with the frontend container binding to localhost port 8280. If you want the container to be accessible on the net, it's recommended to but i.e. an nginx in front.
  • As root, modify /etc/hosts to contain this:
127.0.0.1       db app

Build and start the containers

cat build_all.sh
[execute the commands one by one, as user]

Yes, I mean it - that way you can debug easily.

Login credentials

Login at the URL, by default http://localhost:8280/tt-rss/, with user 'admin' and the password you did choose. Enter 'preferences', and create a further user which you then use for feeds.

Updating

For now, I'm just reading up all items, exporting my feeds, recreating the containers and then importing the feeds again. This will mark all items in the feeds as 'unread'.

Releases

No releases published

Packages

No packages published