Govee2MQTT

Govee2MQTT

Docker app from grtgbln's Repository

Overview

Connect Govee lights and devices to Home Assistant via MQTT.

Readme

View on GitHub

Govee to MQTT bridge for Home Assistant

This repo provides a govee executable whose primary purpose is to act as a bridge between Govee devices and Home Assistant, via the Home Assistant MQTT Integration.

Features

  • Robust LAN-first design. Not all of Govee's devices support LAN control, but for those that do, you'll have the lowest latency and ability to control them even when your primary internet connection is offline.
  • Support for per-device modes and scenes.
  • Support for the undocumented AWS IoT interface to your devices, provides low latency status updates.
  • Support for the new Platform API in case the AWS IoT or LAN control is unavailable.
Feature Requires Notes
DIY Scenes API Key Find in the list of Effects for the light in Home Assistant
Music Modes API Key Find in the list of Effects for the light in Home Assistant
Tap-to-Run / One Click Scene IoT Find in the overall list of Scenes in Home Assistant, as well as under the Govee to MQTT device
Live Device Status Updates LAN and/or IoT Devices typically report most changes within a couple of seconds.
Segment Color API Key Find the Segment 00X light entities associated with your main light device in Home Assistant
  • API Key means that you have applied for a key from Govee and have configured it for use in govee2mqtt
  • IoT means that you have configured your Govee account email and password for use in govee2mqtt, which will then attempt to use the undocumented and likely unsupported AWS MQTT-based IoT service
  • LAN means that you have enabled the Govee LAN API on supported devices and that the LAN API protocol is functional on your network

Usage

Have a question?

Want to show your support or gratitude?

It takes significant effort to build, maintain and support users of software like this. If you can spare something to say thanks, it is appreciated!

Credits

This work is based on my earlier work with Govee LAN Control.

The AWS IoT support was made possible by the work of @bwp91 in homebridge-govee.

Install Govee2MQTT on Unraid in a few clicks.

Find Govee2MQTT in Community Apps on your Unraid server, review the template, and click Install. Unraid handles the Docker app or plugin setup from the published template.

Open the Apps tab on your Unraid server Search Community Apps for Govee2MQTT Review the template variables and paths Click Install
Explore Unraid OS

Requirements


        Requires a separate MQTT broker.
    

Categories

Home AutomationProductivityTools > UtilitiesOther

Related apps

Explore more like this

Explore all
Home AutomationProductivityUtilities appsOther

Links

Projectgithub.comSupportgithub.comGHCRregistry.hub.docker.comTemplateraw.githubusercontent.com

Details

Repository
ghcr.io/wez/govee2mqtt:latest
Registry
https://registry.hub.docker.com/r/ghcr.io/wez/govee2mqtt
Last Updated2026-07-15
First Seen2025-07-14

Runtime arguments

Network
host
Privileged
false

Template configuration

Govee - Account EmailVariable

Govee account email address

Target
GOVEE_EMAIL
Govee - Account PasswordVariable

Govee account password

Target
GOVEE_PASSWORD
Govee - API KeyVariable

Govee API key.

Target
GOVEE_API_KEY
MQTT - HostVariable

MQTT Host

Target
GOVEE_MQTT_HOST
MQTT - PortVariable

MQTT Port

Target
GOVEE_MQTT_PORT
Default
1883
Value
1883
MQTT - UsernameVariable

MQTT Username. Remove if no authentication required.

Target
GOVEE_MQTT_USER
MQTT - PasswordVariable

MQTT Password. Remove if no authentication required.

Target
GOVEE_MQTT_PASSWORD
Temperature UnitVariable

Temperature unit for devices. Celsius or Fahrenheit.

Target
GOVEE_TEMPERATURE_SCALE
Default
C|F
Log StyleVariable

When to use Rust-style colored output for logs

Target
RUST_LOG_STYLE
Default
always
Value
always
Log LevelVariable

Set to 'govee=trace' for debug logs

Target
RUST_LOG