Apprise Notifications from Gitea/Forgejo

Update 2026-07-09 – Added Forgejo support

Since making this post I’ve switched over to Forgejo in my homelab. As such I’ve updated my original project to be more generic in name and function. It now supports both Gitea and Forgejo and a few additional notification types. The new project can be found here: https://git.pickysysadmin.ca/eric/apprise-forge-notifications

Original Post

I guess I’m on a roll for getting more things hooked into Apprise.

Gitea has support for webhook based notifications on certain events but the format Gitea sends them in isn’t compatible with Apprise. Since I am trying to get rid of my reliance on SMTP in my Homelab for notifications I figured I’d give vibe coding a solution a shot.

I had Claude whip me up a middleware that runs in a Docker container you can point your Gitea webhook based notifications at. The middleware will then translate them and pass them on to an Apprise API endpoint of your choosing.

This should probably work with Forgejo too, which is what I would be using, had I not missed the cut off for 1:1 migrations from Gitea to Forgejo. If you end up trying it and it works please drop me a comment to let me know.

I’ve done some light testing and so far so good.

More information can be found in the projects repo: https://git.pickysysadmin.ca/eric/apprise-gitea-notifications

Don’t forget to update your webhook ALLOWED_HOST_LIST in your Gitea config: https://docs.gitea.com/next/administration/config-cheat-sheet#webhook-webhook

Leave a comment

This site uses Akismet to reduce spam. Learn how your comment data is processed.