// 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
Share

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

  1. FIX 1Allow the target

    1. 01In app.ini add [webhook] ALLOWED_HOST_LIST = external,192.168.1.0/24 (or the hostname)
    2. 02Restart Gitea
    Did this fix it?
  2. FIX 2Containers

    1. 01Set GITEA__webhook__ALLOWED_HOST_LIST as an environment variable
    2. 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 us

Watch Gitea Get an email when its price changes, it has an outage, or we publish a new fix. No spam.

Fixed it? Share this guide

The same problem in other apps

All not loading, error messages & connection guides →

Other Gitea errors

All 11 Gitea errors and fixes →