Bug Reports#

Something not working right? Your reports genuinely help shape GlassHome into something better.

Where to Report#

Head to the GlassHome Discord and post in the #bug-reports channel.

What to Include#

The more context you give, the faster I can track it down. Try to include as many of these as you can:

• What happened. Describe what you did and what went wrong. “I tapped the light widget and nothing happened” is better than “light widget broken”.
• What you expected. What should have happened instead.
• Steps to reproduce. Can you make it happen again? Step-by-step instructions help a lot, even if they seem obvious.
• Screenshot or screen recording. A picture is worth a thousand words. A short video of the issue is even better.
• GlassHome version. Found in Settings > About at the bottom of the settings page.
• Device and browser. What are you running GlassHome on? Phone, tablet, desktop? Which browser? This matters for layout and touch issues.
• How you installed GlassHome. HA addon, Docker, or something else? Include the architecture (amd64, aarch64) if you know it.

Getting Logs#

Logs often reveal what went wrong behind the scenes. Here’s how to get them.

HA Addon Logs#

Go to Settings > Add-ons > GlassHome Dashboard > Log in Home Assistant. Copy the output.

Docker Logs#

docker logs glasshome

Browser Console#

Open your browser’s developer tools (F12 or Ctrl+Shift+I), go to the Console tab, and copy any red errors. This is especially useful for UI bugs and widget issues.

Template#

Feel free to copy-paste this into Discord and fill it in:

**What happened:**
[describe the bug]

**Steps to reproduce:**
1. [first step]
2. [second step]
3. [what goes wrong]

**Expected behavior:**
[what should have happened]

**Version:** [e.g. 0.8.2]
**Device:** [e.g. iPad, Chrome on Windows, Pixel 8]
**Install method:** [HA addon / Docker]

**Logs / screenshots:**
[paste logs or attach screenshots]