diff --git a/README.md b/README.md
new file mode 100644
index 0000000..3ad4da3
--- /dev/null
+++ b/README.md
@@ -0,0 +1,37 @@
+# Gitea Runner Debian Builder
+
+Builds `amd64` and `arm64` Debian packages for `gitea-runner` and writes them to the sibling `../gitea-runner-deb` APT repository.
+
+## Requirements
+
+- `curl`
+- `jq`
+- `wget`
+- `xz-utils`
+- `dpkg-dev`
+- `apt-utils`
+- `git`
+
+## Usage
+
+Build the latest Gitea Runner release:
+
+```bash
+./build.sh
+```
+
+Build a specific version:
+
+```bash
+./build.sh 1.0.2
+```
+
+or:
+
+```bash
+GITEA_RUNNER_VERSION=1.0.2 ./build.sh
+```
+
+The script downloads the Linux `amd64` and `arm64` release artifacts, verifies their SHA256 checksums, builds `.deb` packages, moves them into `../gitea-runner-deb`, regenerates `Packages`, `Packages.gz`, and `Release`, then commits the release repo changes locally.
+
+It does not push either repository.