diff --git a/README.md b/README.md
index eda10d3..e53cd56 100644
--- a/README.md
+++ b/README.md
@@ -83,6 +83,13 @@ mastodon::vapid_private_key: >
 mastodon::vapid_public_key: >
   ENC[PKCS7,]
 ```
+
+## Updating your instance
+
+The module deploys a script to do updates. But many updates required extra
+steps that are not included in the script, so use it at your own risk.
+This script requires a Github token with access to read public repositories.
+
 ## Limitations
 
 Tested in Ubuntu