diff --git a/SCRATCH/fqdn-migration-portal.md b/SCRATCH/fqdn-migration-portal.md
new file mode 100644
index 0000000..a8ba321
--- /dev/null
+++ b/SCRATCH/fqdn-migration-portal.md
@@ -0,0 +1,34 @@
+# Portal FQDN Migration — Completed Apr 2, 2026
+
+## Summary
+Portal code defaults and config updated to use internal FQDNs where applicable.
+NEXT_PUBLIC_ env var stays as IP since it runs in the browser.
+
+## next.config.ts — dev origin allowlist expanded
+Added:
+- 10.60.0.19
+- 10.60.0.19:3000
+- zpack-portal.internal.zlh
+- zpack-portal.internal.zlh:3000
+- localhost
+- localhost:3000
+
+## Code defaults updated (old IP 10.60.0.245 → zpack-api.internal.zlh)
+- src/lib/api-client.ts
+- src/lib/api/legacy.ts
+- src/app/(dashboard)/servers/page.tsx
+- src/app/(dashboard)/servers/console/ServerConsole.tsx
+
+## IDE button logic
+- Temporarily changed then fully reverted back to original behavior in page.tsx and ServerConsole.tsx
+
+## Env
+- NEXT_PUBLIC_API_BASE_URL=http://10.60.0.18:4000 — stays as IP (browser-facing, can't resolve internal.zlh)
+- .env is gitignored
+
+## Operational
+- npm ci run to fix missing @jridgewell/trace-mapping dependency
+- Stale next dev processes cleared, clean dev run confirmed (GET / 200)
+
+## Notes
+- package.json shows modified in git status — not intentionally changed this session, worth checking before committing