Home Assistant Auto-Login Setup Guide
=====================================

There are 3 ways to keep the dashboard logged in:

METHOD 1: Long-Lived Access Token (RECOMMENDED)
------------------------------------------------
This is the easiest and most secure method.

1. In Home Assistant (from another device):
   - Click your profile icon (bottom left)
   - Scroll down to "Long-Lived Access Tokens"
   - Click "Create Token"
   - Name it: "Dashboard Kiosk"
   - Copy the token (you'll only see it once!)

2. On this computer, run:
   ~/scripts/configure-ha-token.sh
   
   Then paste the token when prompted.

3. Restart the dashboard:
   ~/scripts/restart-dashboard.sh

The dashboard will now auto-login without showing the login screen!


METHOD 2: Trusted Networks
---------------------------
Configure Home Assistant to trust this computer's IP address.

1. Get this computer's IP:
   hostname -I

2. In Home Assistant, edit configuration.yaml:
   Add this section (or update existing):
   
   http:
     trusted_proxies:
       - 192.168.68.193  # Replace with your IP
     use_x_forwarded_for: true
     ip_ban_enabled: true
     login_attempts_threshold: 5

   OR use the UI:
   - Settings > People & Zones > Trusted Networks
   - Add this computer's IP address

3. Restart Home Assistant

4. The dashboard should now auto-login from this IP


METHOD 3: Firefox Saved Credentials
-------------------------------------
Let Firefox remember your login.

1. Stop the dashboard:
   ~/scripts/stop-dashboard.sh

2. Launch Firefox normally (not kiosk):
   export XDG_RUNTIME_DIR=/run/user/1000
   export WAYLAND_DISPLAY=wayland-0
   MOZ_ENABLE_WAYLAND=1 firefox http://homeassistant.local:8123

3. Log in manually once
4. Firefox will ask to save password - click "Save"
5. Close Firefox
6. Restart the dashboard:
   ~/scripts/restart-dashboard.sh

Firefox should now auto-fill your credentials.


RECOMMENDED: Use Method 1 (Access Token)
It's the most reliable and doesn't require Firefox to save passwords.