diff --git a/runner/README.md b/runner/README.md
new file mode 100644
index 0000000..ac9f2b4
--- /dev/null
+++ b/runner/README.md
@@ -0,0 +1,23 @@
+# Runner
+
+This subfolder of the project adds a github action runner when started with a docker compose.
+Github Actions is the build in CI/CD functionality of github. Runners are the instances that execute the actions required by the CI/CD.
+Github allows runners as a service or selfhosted. Since we will not get accees to the FH-SWF cloud resource we will use the selfhosted version of the runner.
+
+## Configure & Startup
+To start a github runner please add a `.env` config file with key value pairs for the following variables.
+
+```
+ORGANIZATION=fhswf/aki_prj23_transparenzregister
+ACCESS_TOKEN=                                    #
+ARCHITECTURE=arm                                 # Value such as x64,arm64,arm
+HOSTNAME=some-runner-name                        # A name to give to the docker image. Will also be used as a runner name.
+```
+
+An access token can be optained in the Actions ection of the repository or [here](https://github.com/fhswf/aki_prj23_transparenzregister/settings/actions/runners/new).
+
+To startup the runner execute `docker compose up -d --build`.
+Docker needs to be installed. Additionally you may need to execute the docker comands as root.
+
+## Sources
+This runner configuration is based on [this article](https://testdriven.io/blog/github-actions-docker/).