diff --git a/README.md b/README.md
new file mode 100644
index 0000000..b6500f9
--- /dev/null
+++ b/README.md
@@ -0,0 +1,50 @@
+# pkgs
+
+PKGBUILD for my [@tangled.sh](https://tangled.sh/@tangled.sh/core) knotserver setup on [Arch Linux](https://archlinux.org) (because I just can't get my head around nix).
+
+## Install
+
+```bash
+makepkg -D knotserver --install
+```
+
+Yay!
+
+## Additional steps ...
+
+### Secrets
+Obtain a server secret from [/knots](https://tangled.sh/knots), and set `KNOT_SERVER_SECRET` in `/etc/tangled/knotserver`.
+
+```bash
+echo 'KNOT_SERVER_SECRET="..."' > /etc/tangled/knotserver
+```
+
+### Hostname
+
+Either set `/etc/hostname` to the host's FQDN, or override `KNOT_SERVER_HOSTNAME` in `knotserver.service`
+
+```bash
+systemctl edit knotserver.service <<EOF
+[Service]
+Environment="KNOT_SERVER_HOSTNAME=..."
+EOF
+````
+
+### Reverse Proxy
+
+Setup a reverse-proxy to forward `https` requests to `http://localhost:5555`, with a valid SSL certificate.
+
+## Running
+
+```bash
+systemctl enable --now knotserver.service
+```
+
+## SSH
+
+To permit `git` pushes over SSH, enable the `sshd_config.d` drop-in, and modify the `git` user created by the [extra/git](https://archlinux.org/packages/extra/x86_64/git/) package.
+
+```bash
+ln -s /usr/lib/systemd/sshd_config.d/knotserver.conf /etc/ssh/sshd_config.d/30-knotserver.conf
+usermod -s /usr/bin/bash -d /var/lib/tangled git
+```