From 3f6447ab88f92e92b537131f66b967686f23ff06 Mon Sep 17 00:00:00 2001 From: Brad Stein Date: Thu, 30 Apr 2026 16:10:32 -0300 Subject: [PATCH] docs(installer): document explicit gadget rebuild override --- docs/operational-env.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/operational-env.md b/docs/operational-env.md index 42cc4fb..0a36d9d 100644 --- a/docs/operational-env.md +++ b/docs/operational-env.md @@ -11,7 +11,7 @@ from `LESAVKA_CLIENT_PKI_SSH_SOURCE` over SSH. Runtime clients require the insta `ca.crt`, `client.crt`, and `client.key` for HTTPS/mTLS relay connections. | `LESAVKA_ALLOW_GADGET_CYCLE` | document near use before promoting to operator config | -| `LESAVKA_ALLOW_GADGET_RESET` | document near use before promoting to operator config | +| `LESAVKA_ALLOW_GADGET_RESET` | permits installer/recovery flows to reset the USB gadget when a hard rebuild is otherwise required; by itself it must not force a live attached-host reset | | `LESAVKA_ALLOW_INSECURE` | client transport override; permits non-local `http://` relay URLs only for lab/debug use | | `LESAVKA_ALSA_DEV` | server hardware/device override | | `LESAVKA_ATTACH_WRITE_UDC` | server hardware/device override | @@ -106,6 +106,7 @@ from `LESAVKA_CLIENT_PKI_SSH_SOURCE` over SSH. Runtime clients require the insta | `LESAVKA_FAKE_SYSTEMCTL_MODE` | test/build contract variable; not runtime operator config | | `LESAVKA_FOCUS_LAUNCHER_ON_LOCAL` | launcher UI/runtime override | | `LESAVKA_FORCE_CORE_REBUILD_WITHOUT_UDC` | document near use before promoting to operator config | +| `LESAVKA_FORCE_GADGET_REBUILD` | explicit maintenance-window override for hard UDC detach/rebind during server install; pair with `LESAVKA_ALLOW_GADGET_RESET=1` only when a live gadget rebuild is intentional | | `LESAVKA_GADGET_CONFIGFS_ROOT` | server hardware/device override | | `LESAVKA_GADGET_FORCE_CYCLE` | server hardware/device override | | `LESAVKA_GADGET_SYSFS_ROOT` | server hardware/device override |