Add HA-AUTO-LOGIN-GUIDE.txt

HA-AUTO-LOGIN-GUIDE.txt

@@ -0,0 +1,76 @@
+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.