diff --git a/README.md b/README.md
new file mode 100644
index 0000000..b15d4e4
--- /dev/null
+++ b/README.md
@@ -0,0 +1,36 @@
+# Gitea Debian Builder
+
+Builds `amd64` and `arm64` Debian packages for `gitea` and writes them to the sibling `../gitea-deb` APT repository.
+
+## Requirements
+
+- `curl`
+- `jq`
+- `wget`
+- `gpg`
+- `xz-utils`
+- `dpkg-dev`
+- `apt-utils`
+- `git`
+
+## Usage
+
+Build the latest Gitea release:
+
+```bash
+./build.sh
+```
+
+Build a specific version:
+
+```bash
+./build.sh 1.26.1
+```
+
+or:
+
+```bash
+GITEA_VERSION=1.26.1 ./build.sh
+```
+
+The script downloads the Linux `amd64` and `arm64` release artifacts, verifies their GPG signatures and SHA256 checksums, builds `.deb` packages, moves them into `../gitea-deb`, regenerates `Packages`, `Packages.gz`, and `Release`, then commits and pushes the release repo changes.