diff --git a/scripts/taler-merchant/README.md b/scripts/taler-merchant/README.md
index 4ddea4a..2173a28 100644
--- a/scripts/taler-merchant/README.md
+++ b/scripts/taler-merchant/README.md
@@ -30,6 +30,27 @@ Automatic import needs:
 
 SMS backends are symlinks into `/var/taler-src/...` (not copied).
 
+## Self-build deploy (webui tag + merchant master)
+
+From a laptop with `ssh koopa` + `pnpm`/`node` (e.g. clementine):
+
+```bash
+cd ~/src/koopa/koopa-admin-log
+chmod +x scripts/taler-merchant/build-deploy-webui-1.6.11-merchant-master.sh
+./scripts/taler-merchant/build-deploy-webui-1.6.11-merchant-master.sh
+```
+
+What it does:
+
+1. **Clone** `taler-typescript-core` **tag `v1.6.11`**, build SPA, install into  
+   `taler-hacktivism:/usr/share/taler-merchant-webui` (backup `…bak-selfbuild-*`).
+2. **Inside the container:** update `/var/taler-src/merchant` to **master**,  
+   `./bootstrap && ./configure --prefix=/usr && make && make install`.
+3. **`start_merchant.sh --restart`** + smoke `/config` + `/webui/`.
+
+Env knobs: `SKIP_WEBUI=1`, `SKIP_MERCHANT=1`, `SKIP_RESTART=1`,  
+`WEBUI_TAG=…`, `MERCHANT_REF=master`, `KOOPA_SSH=koopa`.
+
 ## Portal / instance IDs: **lowercase only**
 
 Merchant SPA (`/webui/`) and `/instances/{id}/…` require **lowercase** instance