diff --git a/examples/compose/.env.example b/examples/compose/.env.example
index f4625f3..a8c0b48 100644
--- a/examples/compose/.env.example
+++ b/examples/compose/.env.example
@@ -18,3 +18,9 @@ WOODPECKER_AGENT_SECRET=example-agent-secret
 # http://woodpecker:8000/authorize — required before the ci profile starts.
 WOODPECKER_GITEA_CLIENT=
 WOODPECKER_GITEA_SECRET=
+
+# Woodpecker management (repo sync, secret provisioning, pipeline control).
+# Generate a PAT in Woodpecker: profile → Personal Token.
+WOODPECKER_URL=http://woodpecker:8000
+WOODPECKER_API_TOKEN=
+WOODPECKER_REPO_OWNER=
diff --git a/examples/compose/docker-compose.yml b/examples/compose/docker-compose.yml
index fa45997..fd83c66 100644
--- a/examples/compose/docker-compose.yml
+++ b/examples/compose/docker-compose.yml
@@ -39,6 +39,9 @@ services:
       UPDATE_SECRET: ${UPDATE_SECRET:-example-update-secret}
       FILE_CONTAINER_PATH: /softwares
       IMAGE_CONTAINER_PATH: /images
+      WOODPECKER_URL: ${WOODPECKER_URL:-}
+      WOODPECKER_API_TOKEN: ${WOODPECKER_API_TOKEN:-}
+      WOODPECKER_REPO_OWNER: ${WOODPECKER_REPO_OWNER:-}
     depends_on:
       mysql:
         condition: service_healthy