---
title: "Bug Reports"
description: "How to report bugs in GlassHome. What to include, where to find logs, and how to help get it fixed fast."
canonical: https://glasshome.app/docs/bug-reports
section: "Troubleshooting"
updated: 2026-06-09
---
# Bug Reports

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

## Where to Report

Head to the [GlassHome Discord](https://discord.gg/FJYdeDmrzv) 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

```bash
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]
```

> **Not sure if it:** Post it anyway. If it turns out to be a question or a feature request, I'll point you in the right direction.