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.

Copy Diagnostics

Open Settings > General and tap Copy diagnostics. It collects the recent connection log from your server and from this device, and that is most of what I need. On a computer it copies the text to your clipboard. On a phone or tablet it opens the share sheet, so you can send the file on from there. Paste it into your report.

The button is for household admins, and it does not appear on demo.glasshome.app.

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. Shown under Version in Settings > General. The diagnostics include it too.
• 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. Copy diagnostics covers the GlassHome side. If you can’t reach Settings, use the logs below.

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. 1.4.0]
**Device:** [e.g. iPad, Chrome on Windows, Pixel 8]
**Install method:** [HA addon / Docker]

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