Getting Back In When You're Locked Out

Can't sign in to WoowTech? This guide collects the recovery routes available to you — from clearing a forgotten owner password to pulling your data off a device whose login you've lost.

When You Can't Remember Your Username

You're the Owner and the Username Escapes You

If you own the WoowTech server but can't get past the login because the username slipped your mind, you can list every account directly on the machine.

What you'll need: - A WoowTech OS installation - Physical or console access to the server

How to do it:

1. Get a terminal session on the WoowTech host: - WoowTech Green: follow the console-access instructions for that device - WoowTech Yellow: use the steps that match your computer (Windows, Linux, or macOS) - Anything else: plug a keyboard and display straight into the machine - WoowTech OVA: open the system console through whatever hypervisor is running the appliance

2. Run auth list. WoowTech prints out every account it knows about, so you can spot your username.

When You Can't Remember Your Password

You're the Owner and the Password Is Gone

An owner or admin has several avenues for clearing a forgotten password — pick whichever matches your setup.

Resetting an Owner Password

If You're Still Signed In Somewhere

• Regular users: just ask the owner to issue you a new password.
• Owners: there's no in-app "recover my password" button, and a system has exactly one owner, so this route alone won't save you.
• Administrators: create a second admin account, log in as that account, reset the password on your original account, then remove the temporary admin you made.

Resetting via the Console

You'll need console access on the physical device itself.

1. On WoowTech Yellow or Green, jump to that hardware's dedicated guide first.
2. On everything else, reach the device console — either through your virtual machine's console or by attaching a keyboard and monitor.
3. Run the interactive reset:

auth reset --interactive

Pick the account from the list and type in a fresh password when asked. If the shell complains with something like zsh: command not found, you're in the wrong place — make sure you're on the serial console and not inside the in-app terminal.

4. Sign in using the password you just set.

Resetting From a Container Shell

On Docker-style deployments, drop into the container and run the password-change script:

docker exec -it woowtech /bin/bash
hass --script auth --config /config change_password jane.doe NewSecret2026
exit
docker restart woowtech

Resetting Another User's Password From the Web UI (as Owner)

1. Click your account in the lower-left corner to reach the Profile page, then turn on Advanced Mode.
2. Open Settings > People and click the account you want to change.
3. Scroll down and choose Change password.
4. Type the new password and confirm it.
5. Verify the change went through.

Wiping the System to Start Onboarding Over

If none of the reset paths get you in, your last resort is to reset the device and begin onboarding from scratch.

• Have a backup elsewhere? Restore one that includes admin credentials you actually remember.
• No backup? A reset clears everything on the device — there's no way around that loss.
• WoowTech Green: use the Green-specific reset procedure.
• WoowTech Yellow: use the Yellow-specific reset procedure.

Rescuing Your Data First

As long as the storage medium isn't corrupted, your files are still reachable even when the login isn't. Two approaches:

• Hook a USB keyboard and an HDMI display straight to the device, or
• Pop the SD card out and read it from a different computer.

Reading the Device Directly

For Raspberry Pi boards:

1. Cut the power and restore it so the monitor is detected on boot (be aware this carries a small risk of SD-card corruption).
2. Plug in an ordinary USB keyboard.
3. Watch the live dmesg output, then press Enter to break in.
4. Log in as root — no password is needed.

Once you're at the WoowTech CLI, run these without the usual ha prefix:

Reading the SD Card From Another Machine

The data lives on an EXT4 partition named hassos-data, with the working tree under /mnt/data/supervisor.

• Linux: mounts EXT4 natively, so access is straightforward.
• Windows: grab a third-party utility such as Linux Reader (read-only).
• macOS: use something like osxfuse to mount the EXT4 volume.

Removing an Account

You'll need owner or admin rights.

1. Head to Settings > People and select the account to remove. - The owner account can't be deleted.
2. Click Delete at the bottom.
3. Confirm in the popup.