add simpleX notification section

This commit is contained in:
MulliganSecurity 2025-06-11 10:52:01 +02:00
parent d22e8f7bec
commit 47f11d8c1f
13 changed files with 199 additions and 0 deletions

View file

@ -386,6 +386,48 @@ Next, if you want other people to contribute to your Forgejo projects, you'll ha
Once created, simply send the credentials to login to the user that needs them in a private chat (see our recommendation to use [SimpleX chat](../anonsimplex/index.md)).
## **BONUS: adding notifications**
As there is no way to send emails in a secure, anonymous way ForgeJo can be configured to send alerts via [simpleX](../simplexalerts/index.md).
### Target architecture
![](notifs.png)
### Prerequisites
- Using the [simpleX](../simplexalerts/index.md) alerter tutorial, set up an instance listening on localhost:7897, configured with a group to receive your alerts. For the next part
of this tutorial we will be using a group called "forgejotest"
### Forgejo Configuration
First, brows to the repository you want to activate notification for, then go to settings:
![](new_notif.png)
Now click on the webhook in the left-hand side menu then "Add Webhook" and choose "Forgejo"
![](new_notif_2.png)
Now configure your webhook address (here http://localhost:7897/forgejotest where the simpleX Alerter listens).
Here we will configure all the alerts to go to the same channel. To have some alerts go to some channels and not others you can simply create the same webhook but configure different events as we will see.
![](new_notif_3.png)
We will now configure all events currently supported by the alerter (as of 2025-06-11):
![](new_notif_4.png)
Now, make sure the webhook is switched on and activate it.
![](new_notif_5.png)
### Sample alerts
![](sample_notif.png)
## **BONUS: Customizing Forgejo's appearance**
Now if you want to customize your Forgejo instance like i did at <https://git.nowhere.moe> you'll can first create the templates folder to change the homepage:

File diff suppressed because one or more lines are too long

BIN
forgejo-anon/new_notif.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 36 KiB

File diff suppressed because one or more lines are too long

Binary file not shown.

After

Width:  |  Height:  |  Size: 84 KiB

File diff suppressed because one or more lines are too long

Binary file not shown.

After

Width:  |  Height:  |  Size: 51 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 102 KiB

File diff suppressed because one or more lines are too long

Binary file not shown.

After

Width:  |  Height:  |  Size: 74 KiB

File diff suppressed because one or more lines are too long

BIN
forgejo-anon/notifs.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 11 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 49 KiB