// troubleshooting guide · gitea
Gitea Webhook Not Working (ALLOWED_HOST_LIST Error)
- Status
- Workaround available
- platforms:
- Self-hosted, Docker, Helm
- updated:
- November 16, 2026
- reports:
- 3
- Method
- how we research
RUNBOOK · gitea/webhook-not-working2 FIXES
// quick answer
Webhooks to private IPs are blocked by default. Add the target to webhook ALLOWED_HOST_LIST in app.ini.
Most likely fix: Allow the target
How to fix it
// try these in order, the most common fix is first
FIX 1Allow the target
- 01In app.ini add [webhook] ALLOWED_HOST_LIST = external,192.168.1.0/24 (or the hostname)
- 02Restart Gitea
Did this fix it?FIX 2Containers
- 01Set GITEA__webhook__ALLOWED_HOST_LIST as an environment variable
- 02Verify the config actually loaded in Site Administration > Configuration
Did this fix it?
SANDBOX · gitea RUNS IN YOUR BROWSER
Try it: push, review, run CI and merge in a code host and cloud workspace
A hands-on Gitea-style sandbox, including the spots where users get stuck. See where problems like this one start. 1-2 minutes, nothing is saved.
Symptoms
Delivery fails with webhook can only call allowed HTTP servers (check your webhook.ALLOWED_HOST_LIST setting).
Why it happens
- C-01Default list is external so private addresses are blocked
- C-02Setting passed in the wrong section or env var name in containers
// this guide also covers
- gitea webhook allowed_host_list
- gitea webhook not triggering
- gitea webhook private ip
Still not working?
If Gitea keeps failing, you're not alone. See every Gitea problem users report or the alternatives people switch to.
Have an app idea? Our small team builds any software: web and mobile apps, games, desktop, AI tools. Price agreed together.
Talk to usThe same problem in other apps
Other Gitea errors
- Gitea Actions Jobs Stuck in Waiting (No Matching Runner)
- Gitea SSH Permission Denied (publickey) or Connection Refused
- Gitea 500 Internal Server Error
- Gitea Reverse Proxy Wrong URLs or Redirect Loop (ROOT_URL)
- Gitea Push 413 Request Entity Too Large (LFS Upload Fails)
- Gitea Email Notifications Not Sending (SMTP Error)
- Why Is Gitea Using So Much Memory or CPU?
- Gitea Upgrade Failed or Database Is Locked