From 37245194022336200cb3824f8d401eaecef15ae2 Mon Sep 17 00:00:00 2001 From: Joakim Persson Date: Mon, 20 Apr 2026 14:53:07 +0200 Subject: [PATCH] Document devbox-state volume for TUI settings persistence --- DOCKER_HUB.md | 2 ++ README.md | 1 + 2 files changed, 3 insertions(+) diff --git a/DOCKER_HUB.md b/DOCKER_HUB.md index ffd0f3b..2d79a36 100644 --- a/DOCKER_HUB.md +++ b/DOCKER_HUB.md @@ -226,6 +226,7 @@ Understanding what survives container restarts and what doesn't: | `/home/developer/.ssh` | Host bind mount (ro) | ✅ Yes — lives on host | SSH keys | | `/home/developer/.aws` | Host bind mount | ✅ Yes — lives on host | AWS credentials/SSO cache | | `/home/developer/.local/share/opencode` | Named volume (if configured) | ✅ Yes — Docker volume | Session history, memory, auth tokens | +| `/home/developer/.local/state/opencode` | Named volume (if configured) | ✅ Yes — Docker volume | TUI settings (theme, toggles) | | `/home/developer/.local/share/uv` | Named volume (if configured) | ✅ Yes — Docker volume | Python installs, uv tool installs | | `/home/developer/.rustup` | Named volume (if configured) | ✅ Yes — Docker volume | Rust toolchains | | `/home/developer/.cargo` | Named volume (if configured) | ✅ Yes — Docker volume | Cargo binaries, registry cache | @@ -237,6 +238,7 @@ Understanding what survives container restarts and what doesn't: - **Project files** (`/workspace`) are always safe — they're your host filesystem. - **opencode config** is auto-generated from `OPENCODE_PROVIDER` env var on each start if no existing config is found. To persist config changes, mount the config directory from the host (see Custom opencode Config below). - **opencode data** (session history, memory) is lost with `--rm` unless you add a named volume. +- **TUI settings** (theme, toggles) are lost with `--rm` unless you add the `devbox-state` named volume. - **Python installs** via `uv python install` are lost unless you add the `devbox-uv` named volume. - **Rust toolchains** via `rustup-init` are lost unless you add the `devbox-rustup` and `devbox-cargo` named volumes. - **AWS SSO tokens** persist across restarts when `~/.aws` is mounted (recommended for Bedrock users). diff --git a/README.md b/README.md index 4949fae..3686afc 100644 --- a/README.md +++ b/README.md @@ -493,6 +493,7 @@ Container (Debian trixie) | `/home/developer/.ssh` | Host bind mount (ro) | ✅ Yes | SSH keys | | `/home/developer/.aws` | Host bind mount (if configured) | ✅ Yes | AWS credentials/SSO cache | | `/home/developer/.local/share/opencode` | Named volume `devbox-data` | ✅ Yes | Session history, memory | +| `/home/developer/.local/state/opencode` | Named volume `devbox-state` | ✅ Yes | TUI settings (theme, toggles) | | `/home/developer/.local/share/uv` | Named volume `devbox-uv` (if configured) | ✅ Yes | Python installs, uv tool installs | | `/home/developer/.rustup` | Named volume `devbox-rustup` (if configured) | ✅ Yes | Rust toolchains | | `/home/developer/.cargo` | Named volume `devbox-cargo` (if configured) | ✅ Yes | Cargo binaries, registry cache |