diff --git a/CHANGELOG.md b/CHANGELOG.md
index c85c46e..7efd69b 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -8,6 +8,16 @@ Tags follow the pi npm version: `v{pi_version}[letter]` — bare tag for the fir
 
 ## Unreleased
 
+_(no changes since v0.78.1)_
+
+## v0.78.1 — 2026-06-04
+
+First build on pi **`0.78.1`** (upstream `@earendil-works/pi-coding-agent` bump
+from `0.78.0`). Built `FROM` the freshly republished
+`joakimp/pi-devbox:base-pi-only` from opencode-devbox `v1.15.13e`, which carries
+pi `0.78.1` plus the LAN-jump key-persistence work and the `devbox-ssh-local`
+volume ownership fix. Adds compose/env documentation in this repo.
+
 ### Added: persist the LAN-jump key + one-line authorize hint
 
 - **compose:** persist `~/.ssh-local` via a new `devbox-ssh-local` named volume
@@ -18,7 +28,17 @@ Tags follow the pi npm version: `v{pi_version}[letter]` — bare tag for the fir
   `echo '…' >> ~/.ssh/authorized_keys` line when it generates a new key
   (published via opencode-devbox's `base-pi-only`). No helper file to locate.
 
-_(no other changes since v0.78.0c)_
+### Docs: document optional host-owned config in the compose + env templates
+
+- **compose:** added a commented-out `~/.config/devbox-shell` bind mount with a
+  note — the image's `~/.bash_aliases` sources
+  `~/.config/devbox-shell/bash_aliases` if present, and `setup-lan-access.sh`
+  reads `~/.config/devbox-shell/ssh-lan.conf` for named-peer `ProxyJump host`
+  overrides (reach LAN peers by name via `dssh <peer>`).
+- **.env.example:** documented `DEVBOX_HOST_ALIAS` (host hostname to reach,
+  default `host.docker.internal`) so getting-started is self-contained.
+
+Template/example comments only; no behavior change.
 
 ## v0.78.0c — 2026-06-04