diff --git a/examples/gitea/README.md b/examples/gitea/README.md
index f1dcb00..8d006ed 100644
--- a/examples/gitea/README.md
+++ b/examples/gitea/README.md
@@ -1,3 +1,77 @@
 # References
 
-- https://github.com/go-gitea/gitea
\ No newline at end of file
+- https://github.com/go-gitea/gitea
+
+# Notes
+
+After spawning up Gitea, it's recommended to adjust the configuration file `app.ini`.
+
+https://docs.gitea.com/administration/config-cheat-sheet
+
+Typical configuration adjustments:
+
+````
+[service]
+# Allow user registration (only via external auth because of setting below)
+DISABLE_REGISTRATION = false
+# Allow anonymous users to view public content without login
+REQUIRE_SIGNIN_VIEW = false
+# Do not require email confirmation on signup (potential security risk)
+REGISTER_EMAIL_CONFIRM = false
+# Enable email notifications (issues, PRs, etc.)
+ENABLE_NOTIFY_MAIL = true
+# Only allow registration through external providers (OAuth/SSO)
+# Local username/password signup is disabled
+ALLOW_ONLY_EXTERNAL_REGISTRATION = true
+# Enable CAPTCHA (mainly relevant for local registration)
+ENABLE_CAPTCHA = true
+# Hide user email addresses by default
+DEFAULT_KEEP_EMAIL_PRIVATE = true
+# Prevent users from creating organizations by default
+DEFAULT_ALLOW_CREATE_ORGANIZATION = false
+# Enable time tracking features in repositories by default
+DEFAULT_ENABLE_TIMETRACKING = true
+# Default "noreply" email address for commits
+NO_REPLY_ADDRESS = noreply.localhost
+# Hide the "Register" button in the UI
+SHOW_REGISTRATION_BUTTON = false
+# Disable public user directory (/explore/users)
+DISABLE_USERS_PAGE = true
+# Disable passkey (WebAuthn) authentication
+ENABLE_PASSKEY_AUTHENTICATION = false
+# Default visibility for new users:
+# public  = visible to everyone
+# limited = only visible to logged-in users
+# private = only visible to the user and admins
+DEFAULT_USER_VISIBILITY = limited
+
+[openid]
+# Disable OpenID login
+ENABLE_OPENID_SIGNIN = false
+# Disable OpenID-based registration
+ENABLE_OPENID_SIGNUP = false
+
+[repository]
+# Maximum number of repositories a user can create
+MAX_CREATION_LIMIT = 100
+# Prevent automatic repo creation via git push (user namespace)
+ENABLE_PUSH_CREATE_USER = false
+# Prevent automatic repo creation via git push (org namespace)
+ENABLE_PUSH_CREATE_ORG = false
+# Default visibility for new repositories
+DEFAULT_PRIVATE = private
+# Do not force all repositories to be private
+# (users could still create public ones if allowed elsewhere)
+FORCE_PRIVATE = false
+````
+
+## Act Actions
+
+In case you want to use a local Gitea Act runner, you must enable Gitea Actions via the configuration file. 
+
+Please add the following sections to your `app.ini` file:
+
+````
+[actions]
+ENABLED=true
+````