From f62e866eed2dbac17832dfb8ad9f6be1baf193be Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Hern=C3=A2ni=20Marques?= <hernani+magikoopa@vecirex.net>
Date: Fri, 4 Sep 2026 21:44:14 +0200
Subject: [PATCH] lab: mytops-local on koopa and koopa-setup entry

---
 2026/2026-09-04--mytops-local-podman.md | 47 +++++++++++++++++++++++++
 README.md                               |  5 +++
 koopa-setup                             | 27 ++++++++++++++
 3 files changed, 79 insertions(+)
 create mode 100644 2026/2026-09-04--mytops-local-podman.md
 create mode 100644 koopa-setup

diff --git a/2026/2026-09-04--mytops-local-podman.md b/2026/2026-09-04--mytops-local-podman.md
new file mode 100644
index 0000000..7a9e96b
--- /dev/null
+++ b/2026/2026-09-04--mytops-local-podman.md
@@ -0,0 +1,47 @@
+# mytops-local on koopa (podman lab)
+
+**2026-09-04** — merchant http lab next to live goa (not 901x / nym 9080).
+
+## status
+
+| where | port | `/config` |
+|-------|------|-----------|
+| koopa | `127.0.0.1:8288` | 200 (`mytops-local` Up) |
+| magikoopa (ref) | `127.0.0.1:8088` | 200 |
+
+container: `mytops-local` · image `localhost/mytops-debian-systemd:trixie` ·
+bind `~/src/mytops-admin-log` (rsync from laptop; `.git` optional).
+
+docs/run: `mytops-admin-log` branch `mytops-local` → entry `mytops-local` /
+`mytops-local.md`. `STAGE_ENV` unused on this path.
+
+## setup (koopa)
+
+```bash
+rsync -az --delete --exclude .git --exclude .DS_Store \
+  ~/git/mytops-admin-log/ hernani@koopa:src/mytops-admin-log/
+ssh hernani@koopa
+cd ~/src/mytops-admin-log
+podman build -t localhost/mytops-debian-systemd:trixie -f Containerfile.mytops-local .
+MYTOPS_LOCAL_HTTP_PORT=8288 ./scripts/taler-merchant/apply-local-base-url.sh
+podman rm -f mytops-local 2>/dev/null || true
+podman run -d --name mytops-local --hostname mytops-local \
+  --systemd=always --cap-add SYS_ADMIN --security-opt label=disable \
+  -v /sys/fs/cgroup:/sys/fs/cgroup:rw --tmpfs /run --tmpfs /run/lock \
+  -p 127.0.0.1:8288:80 \
+  -v "$HOME/src/mytops-admin-log:/root/mytops-admin-log:rw" \
+  localhost/mytops-debian-systemd:trixie /sbin/init
+podman exec mytops-local bash -lc \
+  'cd /root/mytops-admin-log && MYTOPS_LOCAL_HTTP_PORT=8288 ./scripts/taler-merchant/setup-local.sh'
+```
+
+if dbconfig fails (`policy-rc.d`): start `postgresql`, then dbconfig + `taler-merchant.target`.
+
+## links
+
+| what | where |
+|------|--------|
+| koopa-setup | `koopa-setup` |
+| lab-local | `configs/lab-local/` · `configs/ports.md` |
+| mytops-admin-log | branch `mytops-local` |
+| regio lab | `configs/lab-local/goa-regio-ng-koopa.yml` · `~/src/regio-local/` |
diff --git a/README.md b/README.md
index e6b5015..47aab15 100644
--- a/README.md
+++ b/README.md
@@ -6,6 +6,11 @@ Ops log and config mirror for host **koopa** (openSUSE Tumbleweed).
 
 **Secrets:** not in this repo — see **`SECRETS.md`** and sibling **`koopa-admin-secrets`**.
 
+## FIND / setup entry
+
+Plain file **`koopa-setup`** — lab + host pointers (mytops-local, regio-ng,
+ports, daylogs). Start there before hunting under `configs/` / `2026/`.
+
 ## Open issues
 
 **Visible issue list:** [`ISSUES.md`](ISSUES.md)
diff --git a/koopa-setup b/koopa-setup
new file mode 100644
index 0000000..0a18930
--- /dev/null
+++ b/koopa-setup
@@ -0,0 +1,27 @@
+# koopa-setup
+
+# lab / host setup pointers (clone: ~/git/admin-logs/koopa-admin-log). stay on main.
+
+## lab local (loopback only — never 901x / 9080)
+
+configs/lab-local/README.md
+configs/lab-local/mytops-local.toml
+configs/lab-local/goa-regio-ng-koopa.yml
+configs/ports.md
+
+## mytops-local
+
+2026/2026-09-04--mytops-local-podman.md
+# outward: ~/git/mytops-admin-log → git switch mytops-local
+
+## goa-regio-ng
+
+2026/2026-09-04--goa-backup-regio-ng.md
+# outward: ~/src/regio-local/
+
+## host map
+
+host/overview/
+configs/caddy/
+SECRETS.md
+ISSUES.md