xazziri/docker-rss2email repository overview

⁠(docker-)rss2email

Docker container with rss2email installed on Debian minimal.

⁠Build the image

docker buildx build . --output type=docker -t xazziri/docker-rss2email:latest

⁠Run the image

Use the supplied docker-compose file:

docker compose up -d

⁠Change the rss2email settings

Edit the rss2email.cfg file in the config folder. Here one can change from and to addresses, mail settings, smarthost address etc. For more info, see the rss2email github page.

⁠Change the feeds

Change the rss2email.cfg file in the config folder. Add the feed to the bottom of the file and wait 15 minutes. The share folder contains the rss2email.json file, which keeps track of processed articles

⁠Change the update frequency

The update frequency is regulated by a crontab entry. Default is set to every 15 minutes. This can be changed in the Dockerfile, using normal crontab layout. Please rebuild the container afterwards.

⁠Connect to the container

If you want to connect to the container, run:

docker exec -it docker-rss2email /bin/bash

You will be root.

⁠Manual run

Connect to the container and run this to do a manual run:

r2e run

Use add to subscribe to an RSS feed. For example, to subscribe to the Arch Linux package updates feed, run:

r2e add name-for-rss https://www.feed.url e-mail@address

Note that an e-mail address only has to be given if the feed is to be delivered to an address other than the default one; otherwise, leaving off the e-mail address is acceptable. After a new feed is added, rss2email will e-mail every post it has not previously e-mailed. The first time it is run, therefore, it will e-mail every post. To avoid this behavior, after adding a new feed, run: Do do a manual run without sending do:

r2e run --no-send

To change your default TO: email address without editing rss2email.cfg do:

r2e email [email protected]

To view feeds previously added to rss2email, run:

r2e list

This will output a numbered list of feeds. To delete a feed, run:

r2e delete number

where number is the number of the feed to be deleted.

Not needed with this image, but if you need to start from scratch with rss2email, first thing is to tell rss2email where it should send feeds by running the command:

r2e new [email protected]