Repository navigation
TUI wizard runs every launch — should only run on first use #8
Description
Activity
Design Decision (from planning session)
Config persistence format: YAML (
config.yaml)Storage location priority:
- Persistent USB storage (when persistence partition exists)
- Overlay filesystem as fallback (when no persistence partition)
Root cause identified: The wizard's
_finalize()wraps ALL writes in a broadtry/except Exception: passthat silently swallows errors. Since the TUI runs asneuraldrive-admin(not root), writing to/etc/neuraldrive/likely fails with a permission error → sentinel never created → wizard runs again every launch.Fix approach:
- Fix permissions so wizard can write config (use sudo or have first-boot.sh set ownership)
- Replace silent exception swallowing with proper error logging/display
- Move config storage to YAML file on persistent storage
- Sentinel check should also consider alternative signals (e.g., config.yaml existence)
Symptom
The first-boot wizard appears every time the TUI is launched, not just the first time.
Expected Behavior
The wizard should run once on first use, then never again. Choices made during the wizard should be persisted — either written as permanent config changes (e.g., enabling SSH, setting passwords) or saved to a config file (e.g.,
/etc/neuraldrive/config.yamlor similar).On subsequent TUI launches, the wizard should be skipped entirely. The sentinel file
/etc/neuraldrive/first-boot-completeexists for this purpose but either isn't being checked or isn't being written after wizard completion.Suggested Fix