From 440218fc4cfe07279ff8b8d03301875b0813f67d Mon Sep 17 00:00:00 2001
From: pi <pi@devbox>
Date: Thu, 4 Jun 2026 13:34:10 +0200
Subject: [PATCH] compose: document optional ~/.config/devbox-shell mount (LAN
 ssh-lan.conf + bash_aliases bridge)

---
 docker-compose.yml | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/docker-compose.yml b/docker-compose.yml
index 1d27041..4505208 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -95,6 +95,14 @@ services:
       # - ~/.bash_aliases:/home/developer/.bash_aliases:ro
        # - ~/.inputrc:/home/developer/.inputrc:ro
 
+      # Optional: host-owned shell config + LAN jump overrides (recommended
+      # over the single-file ~/.bash_aliases mount above — it's a directory,
+      # so it survives editors' atomic-save). 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 (see ssh-lan.conf.example).
+      # - ~/.config/devbox-shell:/home/developer/.config/devbox-shell:ro
+
       # Optional: persist uv data (Python installs, tool installs)
       # Without this, 'uv python install' must be re-run after container removal.
       - devbox-uv:/home/developer/.local/share/uv