diff --git a/.woodpecker.yml b/.woodpecker.yml
new file mode 100644
index 0000000..d606c61
--- /dev/null
+++ b/.woodpecker.yml
@@ -0,0 +1,12 @@
+when:
+  - event: push
+
+steps:
+  - name: hello
+    image: alpine:3.20
+    commands:
+      - echo "Hello from $CI_REPO_NAME on Woodpecker"
+      - echo "Commit: $CI_COMMIT_SHA"
+      - echo "Author: $CI_COMMIT_AUTHOR"
+      - uname -a
+      - date -u
diff --git a/README.md b/README.md
index ca05627..d00cbf9 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,10 @@
 # hello-platform
 
-First repo on the live platform — proves git + CI + OCI work end-to-end
\ No newline at end of file
+First repo on the arcaptyp deployment server (Hetzner / dev.450labs.net).
+
+This repo exists to verify the platform's git + CI + OCI registry chain
+works end-to-end. Pushing anything to `main` should trigger the
+`.woodpecker.yml` pipeline on the in-house Woodpecker instance and run
+the `hello` step against `alpine:3.20`.
+
+Provisioned 2026-05-18.