diff --git a/docs/docs/30-administration/20-vcs/30-gitea.md b/docs/docs/30-administration/20-vcs/30-gitea.md
index 7904614df..66ee0cd61 100644
--- a/docs/docs/30-administration/20-vcs/30-gitea.md
+++ b/docs/docs/30-administration/20-vcs/30-gitea.md
@@ -24,6 +24,14 @@ services:
 
 Register your application with Gitea to create your client id and secret. You can find the OAuth applications settings of Gitea at `https://gitea.<host>/user/settings/`. It is very import the authorization callback URL matches your http(s) scheme and hostname exactly with `https://<host>/authorize` as the path.
 
+If you run the Woodpecker CI server on the same host as the Gitea instance, you might also need to allow local connections in Gitea, since version `v1.16`. Otherwise webhooks will fail. Add the following lines to your Gitea configuration (usually at `/etc/gitea/conf/app.ini`).
+```ini
+...
+[webhook]
+ALLOWED_HOST_LIST=external,loopback
+```
+For reference see [Configuration Cheat Sheet](https://docs.gitea.io/en-us/config-cheat-sheet/#webhook-webhook).
+
 ![gitea oauth setup](gitea_oauth.gif)
 
 
diff --git a/docs/docs/30-administration/20-vcs/40-gitlab.md b/docs/docs/30-administration/20-vcs/40-gitlab.md
index b350a7634..7c859dda8 100644
--- a/docs/docs/30-administration/20-vcs/40-gitlab.md
+++ b/docs/docs/30-administration/20-vcs/40-gitlab.md
@@ -25,6 +25,8 @@ You must register your application with GitLab in order to generate a Client and
 
 Please use `http://woodpecker.mycompany.com/authorize` as the Authorization callback URL. Grant `api` scope to the application.
 
+If you run the Woodpecker CI server on the same host as the GitLab instance, you might also need to allow local connections in GitLab, otherwise API requests will fail. In GitLab, navigate to the Admin dashboard, then go to `Settings > Network > Outbound requests` and enable `Allow requests to the local network from web hooks and services`.
+
 ## Configuration
 
 This is a full list of configuration options. Please note that many of these options use default configuration values that should work for the majority of installations.