From bb556d2c8206cf1d553dd354302e9d71109fc96c Mon Sep 17 00:00:00 2001 From: jay23606 <4602056+jay23606@users.noreply.github.com> Date: Mon, 26 Oct 2026 03:38:42 -0400 Subject: [PATCH] docs: explain cleanup after database loss Co-Authored-By: Claude Haiku 5.5 Signed-off-by: jay23606 <4602056+jay23606@users.noreply.github.com> --- docs/guide/platform/installation/uninstall.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/guide/platform/installation/uninstall.md b/docs/guide/platform/installation/uninstall.md index 76f6f19f4..520e0cacb 100644 --- a/docs/guide/platform/installation/uninstall.md +++ b/docs/guide/platform/installation/uninstall.md @@ -91,6 +91,8 @@ If installation configured Cloudflare Access, the uninstall plan lists its recor Uninstall does not remove the applications created for [project Zero Trust](/guide/platform/administration/zero-trust). While Zero Trust is enabled or still has Access applications, uninstall and `--plan` stop before any change and list those applications. Run `void platform zero-trust disable` first. Uninstall reads this from the installation database, so it also stops when the database cannot be reached. +If the installation database is permanently gone and cannot be restored, there is no uninstall command that can clear the local installation record or list its Cloudflare resources. Once you have decided not to recover that installation, delete `~/.void/platforms//.json` and any sibling `.recovery.enc` or `.secrets.enc` files. This removes only local state and encrypted credentials; it does not delete Cloudflare resources. Review and remove those resources manually using [Remove retained resources](#remove-retained-resources). + If no platform user exists yet, for example because first administrator setup did not finish, nobody can run `zero-trust disable`. Uninstall then turns off project Zero Trust and deletes its applications itself. Run it on the computer that installed