What is ratgdo and how does it work with a garage door opener?

ratgdo is a small open-source hardware board. It gives you local control over a LiftMaster or Chamberlain garage door opener. It does not use the myQ cloud and has no subscription fee. The name is widely cited to stand for "Rage Against the Garage Door Opener," a reference to Chamberlain's 2023 decision to block third-party apps from connecting to myQ. That decision cut off Home Assistant, Apple HomeKit, and other platforms. After that, the ratgdo project became one of the most popular workarounds for users who want garage door control without relying on a cloud service.

What ratgdo actually is

ratgdo is a small circuit board, roughly the size of a USB drive. It connects to the same data bus on your opener that the wall-mounted control panel uses. This data bus is called the Security+ 2.0 bus. It is found on LiftMaster and Chamberlain openers with a yellow learn button.

The board has a Wi-Fi radio and runs ESPHome firmware. ESPHome is an open-source firmware platform. It lets smart home devices talk to Home Assistant, MQTT brokers, and other local systems. When ratgdo is wired to the opener and connected to your home Wi-Fi, it can send and receive commands through the data bus. It does not use the radio remote system at all.

This is different from a simple dry-contact relay device. A relay can only simulate pressing the wall button. It sends one signal and stops there. ratgdo reads the full data stream from the opener. It can report the actual door state (open, closed, stopped), the obstruction sensor state (clear or blocked), the opener's light status, and other data. It can also lock the door from remote triggers, which is useful for security automations in Home Assistant.

What ratgdo can control

The ratgdo feature list from Paul Wieland's documentation includes:

• Open and close the door
• Stop the door at any position mid-travel
• Query the current door state (open, closed, opening, closing, stopped)
• Check obstruction sensor status in real time
• Toggle the opener's built-in light on or off
• Enable or disable radio frequency remote lockout (so no remotes work until unlocked)
• Motion detection output (on openers that have the built-in motion sensor)

All of these run on your home network with no internet required. No internet connection is needed to send commands or receive status updates. If your internet goes down, your garage door still works through ratgdo. This is the main reason Home Assistant users prefer ratgdo over any cloud-dependent option.

A practical example: you can set up a Home Assistant automation that closes the door at 10 PM if it is left open. The automation checks the door state via ratgdo, sees that the door is open, and sends a close command. This all happens inside your home network. No data leaves your house. Chamberlain's myQ app sends all commands through Chamberlain's servers in the cloud, meaning a server outage or an account suspension could lock you out. ratgdo removes that dependency entirely.

How it connects to Home Assistant and HomeKit

Home Assistant: ratgdo shows up in Home Assistant as a native ESPHome device. Install the ESPHome add-on in Home Assistant. After that, ratgdo appears in the Devices panel. Add it with one click and start using it in automations. No custom integration or HACS component is needed for basic use.

Apple HomeKit: ratgdo does not connect to HomeKit on its own. The path to HomeKit goes through Homebridge. Homebridge is a software bridge that translates non-HomeKit devices into HomeKit accessories. Install Homebridge on a Raspberry Pi, a NAS, or a spare computer on your home network. Then install the Homebridge ratgdo plugin. After that, the garage door shows up in the Apple Home app and on the iPhone lock screen.

MQTT: ratgdo also works with MQTT. MQTT is a lightweight messaging protocol used in home automation. If you run an MQTT broker (like Mosquitto) on your home network, ratgdo can send door state updates to a topic and receive commands from one. This is the path used by Node-RED and Home Assistant's MQTT integration.

Setting up ratgdo takes about 1 to 2 hours for a first-time ESPHome user. The steps are: flash the ratgdo firmware to the board via USB, wire the board to the opener's data terminals and power terminals, connect to your Wi-Fi through the ESPHome web interface, and then add the device to Home Assistant or Homebridge. Paul Wieland's documentation at paulwieland.github.io/ratgdo walks through each step with photos.

Who should use ratgdo

ratgdo is best suited for people who:

• Have a LiftMaster or Chamberlain opener with a yellow learn button (Security+ 2.0)
• Already use Home Assistant or are willing to set it up
• Prefer local, cloud-free control
• Are comfortable flashing firmware to a small board via a USB cable (a one-time setup step)
• Want full feature access including obstruction sensor status, door lock, and light control

It is not the right fit for people who: - Have a Security+ 3.0 opener (white learn button) - ratgdo does not work with this protocol - Want a plug-and-play option with no technical setup - Do not want to run Homebridge or Home Assistant on their home network

For those cases, the Meross MSG100HK ($30, dry-contact, Matter-certified) is a simpler HomeKit option that works on any opener, including Security+ 3.0. The Konnected GDO blaQ ($90) is a plug-and-play ratgdo alternative for Security+ 2.0 openers that does not require firmware flashing.

Wiring ratgdo to the opener is the step most users find intimidating, but it is not difficult. Most LiftMaster and Chamberlain openers have labeled terminals on the back or side of the motor unit. Look for terminals labeled "GND" (ground), "OBS" or "WHITE" (data), and a 12V or 18V power terminal. ratgdo uses three wires: ground, data, and power. The documentation includes a wiring diagram for the most common LiftMaster and Chamberlain models. The connection is the same as adding a wired wall button. No soldering is required. The wires are small (22 gauge) and connect with simple screw terminals on both the ratgdo board and the opener. Total wiring time is about 10 minutes once the board is flashed.

Comparison: ratgdo vs. other myQ alternatives

Device	Price	HomeKit path	Setup level	Works SP3.0	Local only
ratgdo	$60-$65	Homebridge	Technical	No	Yes
Konnected GDO blaQ	$90	Native	Easy	No	Yes
Meross MSG100HK	$30	Native (Matter)	Easy	Yes	No (cloud assisted)

The blaQ runs a version of ESPHome similar to ratgdo and has a nearly identical feature list, but it comes pre-flashed and configured. The tradeoff for the easier setup is the higher price. For most non-technical users, the blaQ is a better starting point. For someone who already has Home Assistant and is comfortable with ESPHome, ratgdo saves roughly $25 to $30 compared to the blaQ and gives the same local control.

G Brothers installs and services all major opener brands in the Denver metro and Front Range. If you need help identifying your opener's learn button color or checking Security+ compatibility before you buy, free estimates are available and same-day service is standard.