diff --git a/README.md b/README.md
index c609477..3fe2caa 100644
--- a/README.md
+++ b/README.md
@@ -15,7 +15,15 @@ To host the renovate config.
 
 ## requirements
 1. Create a new bot account e.g. renovate-bot.
-2. Create a personal access token (*PAT*) for your renovate-bot account.
+2. Create a personal access token (*PAT*) for your renovate-bot account with the following scopes:
+   1. activitypub: no access
+   2. issue: read and write
+   3. misc: read
+   4. notifications: read
+   5. organization: read
+   6. package: read (if you use forgejo packages)
+   7. repository: read and write
+   8. user: read
 3. Create a new organisation e.g. homelab.
 4. Add your renovate-bot account as owner to the organization.
 5. Add renovate-bot *PAT* as a secret (*RENOVATE_TOKEN*) in the organization.
@@ -23,8 +31,8 @@ To host the renovate config.
 
 ### additions
 
-1. GitHub Access Token (read only)
-2. Docker.io login credentials
+1. Generate your GitHub access token (read only) under Settings / Developer Settings
+2. Docker.io login credentials (username and access token)
 
 ## acknowledgments