diff --git a/.woodpecker.yml b/.woodpecker.yml
index 68e40d6..15de89d 100644
--- a/.woodpecker.yml
+++ b/.woodpecker.yml
@@ -2,10 +2,10 @@
 # Deploys static site to Linode VPS via Docker
 # Documentation: https://woodpecker-ci.org/docs
 
-# Trigger: Push to main branch or tag creation
+# Trigger: Push to main, tag creation, or manual run from Woodpecker UI
 when:
   branch: main
-  event: [push, tag]
+  event: [push, tag, manual]
 
 steps:
   # ============================================
@@ -99,3 +99,8 @@ steps:
 # Portainer: Add stack from "Git repository" with this repo, compose path
 #   docker-compose.yml. Enable GitOps → Webhook and "Re-pull image".
 #   Add Gitea registry in Portainer (Settings → Registries) so the host can pull.
+#
+# If pipeline doesn't run on push: ensure the repo is activated in Woodpecker,
+# Gitea has a webhook to Woodpecker for this repo, and your default branch is main.
+# If Gitea and Woodpecker run on the same host, Gitea may need [webhook]
+# ALLOWED_HOST_LIST=external,loopback in app.ini so webhooks can reach Woodpecker.