diff --git a/compose-snippets/act_runner_config.yaml b/compose-snippets/act_runner_config.yaml
new file mode 100644
index 0000000..0da91d9
--- /dev/null
+++ b/compose-snippets/act_runner_config.yaml
@@ -0,0 +1,16 @@
+# act_runner config — passes Docker socket into job containers
+# so workflow steps can run docker login, docker build, etc.
+#
+# Place this file at /srv/act-runner/config.yaml on the host
+# before deploying the act_runner stack.
+
+runner:
+  capacity: 2
+
+container:
+  # Pass the host Docker socket into every job container
+  docker_host: unix:///var/run/docker.sock
+  options: -v /var/run/docker.sock:/var/run/docker.sock
+  privileged: true
+  valid_volumes:
+    - /var/run/docker.sock