# Govee2MQTT

Govee2MQTT is a bridge that connects Govee lights and devices to Home Assistant via MQTT, enabling LAN-first control and scene support for home automation users. It is open source and self-hosted, installable on Proxmox and Unraid.

Canonical page: https://ourlocalhost.com/app/2857/govee2mqtt

## Description

Govee2MQTT is a bridge that connects Govee lights and devices to Home Assistant via MQTT, enabling LAN-first control and scene support for home automation users.

## Platform availability

Available on 2 of 10 platforms: Unraid, Proxmox.

## Health score

53/100 (Fair), based on 4 of 5 factors.
- Maintained: 51 (last commit 223 days ago)
- Popular: 63 (1,491 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Security check: 60 (no serious findings, 7 minor, CI)

## Links

- Proxmox: https://community-scripts.github.io/ProxmoxVE/scripts?id=govee2mqtt
- Unraid: https://ca.unraid.net/apps/govee2mqtt-1b3lb6k1vk2jzs?q=Govee2MQTT

## Common questions

### What .env settings are required before starting Govee2MQTT in Docker?

Create the .env file with your Govee account details and the MQTT broker host and port. Without them, the app cannot sign in or send your Govee devices to Home Assistant.

### Why should Govee2MQTT use Docker host networking?

Set network_mode: host so the app can see your local network directly. This helps it find Govee devices on your LAN; without it, some devices may not appear even if they are on the same network.

### How can Govee2MQTT settings be preserved after container rebuilds or upgrades?

Mount a Docker volume for /data, such as govee2mqtt_data:/data, so saved settings and state remain. If you do not, rebuilding the container can wipe the configuration you entered.

### Which Govee2MQTT features require a Govee API key?

DIY scenes, music modes, and segment color require an API key. Tap-to-run requires IoT account credentials, while live status updates can use LAN and/or IoT.

### Can the Home Assistant add-on be updated without restarting Home Assistant?

Yes, you can update govee2mqtt without restarting the whole Home Assistant instance.

---
Source: Our Local Host (https://ourlocalhost.com/app/2857/govee2mqtt), the self-hosted and open-source app directory.
