---
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/dash/bug-reports
section: "Troubleshooting"
updated: 2026-10-08
---
# 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.

## 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

```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. 1.4.0]
**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's a bug?:** Post it anyway. If it turns out to be a question or a feature request, I'll point you in the right direction.