From 0aa4e3aef80bdf879d4249012be9af5944a0618c Mon Sep 17 00:00:00 2001
From: Honza Hommer <2045468+honzahommer@users.noreply.github.com>
Date: Sat, 23 May 2026 16:05:31 +0200
Subject: [PATCH] Add usage for matrix notify plugin #6980

---
 notify.md | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/notify.md b/notify.md
index 418cd94..e9b442a 100644
--- a/notify.md
+++ b/notify.md
@@ -764,3 +764,21 @@ acme.sh --set-notify --notify-hook opsgenie
 ```
 
 The configuration will be saved in ~/.acme.sh/account.conf and will be reused when needed.
+
+## 27. Set notification for Matrix ##
+
+First get your Matrix Homeserver URL (e.g. https://matrix-client.matrix.org), API token, Room ID and set them in your systems environment:
+
+```sh
+export MATRIX_SERVER_URL="..." # overwrites Matrix Homeserver URL 
+export MATRIX_API_TOKEN="..."  # overwrites Matrix Access token
+export MATRIX_ROOM_ID="..."    # overwrites Matrix Room ID
+```
+
+Ok, let's set notification hook:
+
+```
+acme.sh --set-notify --notify-hook matrix
+```
+
+The `MATRIX_SERVER_URL`, `MATRIX_API_TOKEN` and `MATRIX_ROOM_ID` will be saved in ~/.acme.sh/account.conf and will be reused when needed.
\ No newline at end of file