Summary
When installation or onboarding fails, the known workaround is to run uninstall.sh before trying again. This recovery path is not documented in product output and suggests the setup flow is not idempotent.
Problem
Users should not need to discover from external notes that a full uninstall is required to recover from a transient namespace or gateway failure.
Expected behavior
Onboarding should either be safely rerunnable or should print an explicit cleanup step when the environment cannot be reused.
Acceptance criteria
- Failed onboarding attempts can be retried without a full manual uninstall in common cases.
- If a retry requires cleanup, the CLI prints the exact remediation command.
- The troubleshooting docs include the current rerun failure modes.
- A test covers rerunning onboarding after an interrupted or failed setup.
Summary
When installation or onboarding fails, the known workaround is to run
uninstall.shbefore trying again. This recovery path is not documented in product output and suggests the setup flow is not idempotent.Problem
Users should not need to discover from external notes that a full uninstall is required to recover from a transient namespace or gateway failure.
Expected behavior
Onboarding should either be safely rerunnable or should print an explicit cleanup step when the environment cannot be reused.
Acceptance criteria