diff --git a/.actrc b/.actrc
new file mode 100644
index 00000000..994867be
--- /dev/null
+++ b/.actrc
@@ -0,0 +1,6 @@
+# Act Configuration for local GitHub Actions testing
+# Maps runner labels to Docker images
+# Format: -P label=image (one per line, or use test-workflow.sh script)
+
+-P php-ci=php-ci:latest
+-P docker-build=docker:latest
diff --git a/test-workflow.sh b/test-workflow.sh
new file mode 100755
index 00000000..3404be4a
--- /dev/null
+++ b/test-workflow.sh
@@ -0,0 +1,9 @@
+#!/bin/bash
+# Script to test Gitea workflows locally with act
+# Maps custom runner labels to Docker images
+
+act -P php-ci=php-ci:latest \
+    -P docker-build=docker:latest \
+    -P ubuntu-latest=ubuntu:latest \
+    -P ubuntu-22.04=ubuntu:22.04 \
+    "$@"