MonitoRSS RSS bot (formerly known as Discord.RSS) with customizable feeds. https://monitorss.xyz
Delivers highly-customized news feeds to Discord!
To use the publicly hosted instance for free, visit https://monitorss.xyz!
Docker is required to easily coordinate and run multiple services at once.
[!NOTE]
General knowledge of how Docker, Docker volumes, and docker compose works is highly recommended to avoid accidental data loss
main
(the default) branch - git clone https://github.com/synzen/MonitoRSS.git
.env.example
file and rename it to .env.prod
.env.prod
file with your own values
BACKEND_API_MONGODB_URI
to your MongoDB URIBACKEND_API_SESSION_SECRET
to a random 64-character stringBACKEND_API_SESSION_SALT
to a random 16-character stringhttp://localhost:8000/api/v1/discord/callback-v2
to the list of redirect URIs in your Discord application in the OAuth2 pagedocker compose up -d
docker compose --parallel 1 up -d
http://localhost:8000
in your .env.prod
to your desired domain. For example, https://mynewdomain.com
.{DOMAIN_HERE}/api/v1/discord/callback-v2
to the list of redirect URIs in your Discord application in the OAuth2 page, replacing DOMAIN_HERE
with the value you set in step 1While email notifications are available so that you may get notified when feeds are disabled for various reasons (permission erorrs, request errors, etc), credentials must be set to be able to send them out. Set the three variables below with your email provider's SMTP settings in your env file:
BACKEND_API_SMTP_HOST
BACKEND_API_SMTP_USERNAME
BACKEND_API_SMTP_PASSWORD
BACKEND_API_SMTP_FROM
Make sure to opt into email notifications in the control panel's user settings page afterwards.
docker compose down
docker compose up -d --build
If you've been using MonitoRSS v6 (used by the repo https://github.com/synzen/MonitoRSS-Clone), then these are instructions to migrate off of that repo to use the latest changes.
It's recommended that you don't delete your v6 files until you've confirmed that all your feeds are working as expected post-migration.
.env.prod
file, set BACKEND_API_MONGODB_URI
to your MongoDB URIdocker compose --parallel 1 up -d --build
docker compose --parallel 1 up -d