Quick take: ratgdo is a local-control garage door option for many Chamberlain and LiftMaster openers. Flash the board first, wire it only with the opener unplugged, then mount it where the USB power cable and terminal wires are protected.
The Worm Pop Labs ratgdo enclosure is the part that keeps the project tidy after the exciting bit is done. The board still needs correct firmware, correct wiring, and a safe power path; the enclosure gives the finished install a protected place to live.
Why people use ratgdo instead of cloud garage control
Many smart garage setups used MyQ until local integrations became unreliable or disappeared. ratgdo takes a different route: it talks to compatible garage door opener control terminals and exposes useful door status, light, obstruction, and motion entities through local firmware such as ESPHome or HomeKit.
For Home Assistant users, that matters because the garage door becomes part of the local smart-home system instead of a cloud service that can change terms, break an integration, or slow down when the internet is out. You still need to treat the garage door as moving equipment, not as a toy switch.
Check compatibility before buying parts
Start at the opener, not at the software. Chamberlain and LiftMaster Security+ openers are common targets, including many units with yellow, purple, red, or orange learn buttons. Security+ 2.0 openers in North America usually use the red, white, and black ratgdo wiring path. Some European Security+ 2.0 openers use an e-serial terminal instead, and dry-contact openers need additional position switches if you want real open and closed status.
If your opener is old, unusual, or already has several accessories sharing terminals, read the official wiring diagram for your ratgdo board revision before ordering an enclosure. The case protects the board; it does not make an incompatible opener compatible.
Parts and tools for a clean install
| Item | Why it matters | Buying note |
|---|---|---|
| ratgdo board | The controller that connects the opener to local firmware. | Match the board revision to the firmware and wiring diagram you plan to use. |
| Ratgdo Enclosure For 32, 2.5,2.52i, 2.5i, 2.53i etc Holster Case — Toolless Enclosure for ESPHome / MyQ | Protects and mounts the board after testing. | The listing includes the enclosure and VHB tape; the ratgdo board is not included. |
| USB data cable | Needed for flashing many boards and powering the device. | Use a real data cable for flashing, not a charge-only cable. |
| USB power supply | Powers ratgdo after the opener is plugged back in. | Route it so it cannot be pulled by the moving door or rail. |
| Small screwdriver and wire labels | Help keep the opener terminals readable while you work. | Photograph the original wiring before changing anything. |
| Wall Mount for RYOBI 40V Batteries — Garage Organization | Optional garage organization | Use it away from the opener wiring area to keep 40V tool batteries on the wall instead of a shelf. |
Phase 1: flash firmware before wiring
Do the firmware work at a desk before the board is anywhere near the opener. ratcloud’s firmware instructions call for Chrome or another Chromium browser when using Web Serial. ratgdo32 boards may support wireless setup when the blue light is flashing, while v2.5x boards commonly use a micro-USB data cable and may need the CH340 USB-to-UART driver.
- Connect the ratgdo board directly to your computer, not through a monitor hub.
- Open the official ratgdo ESPHome or HomeKit firmware flasher for the firmware you plan to use.
- Install the firmware, erase when prompted if you are starting fresh, and enter WiFi credentials when the tool asks.
- Open the ratgdo web UI once it joins WiFi and confirm the board is reachable before going to the garage.
Phase 2: wire only with the opener unplugged
The official ratgdo wiring instructions are blunt: install and configure firmware first, unplug the door opener, connect the wires according to the correct diagram, plug the opener back in, then power ratgdo from USB. Do not work on opener terminals while the unit is powered.
For many North American Security+ 1.0 and Security+ 2.0 openers, the red, white, and black ratgdo wires connect to the corresponding opener terminals. If your opener has multiple wires already sharing a terminal, photograph them first and keep the wall button and obstruction sensor wiring intact. For dry-contact openers, red and white handle the wall-control path, but limit switches are needed if you want proper position status instead of simple toggle behavior.
Phase 3: confirm Home Assistant before mounting
If you choose ESPHome firmware, Home Assistant can discover the device once it is on your network. Add it under Settings, Devices and services, then confirm the door position, obstruction state, light, and motion entities make sense. If you use MQTT firmware, configure the broker and topics before building automations around it.
Do a few local tests with the board accessible. Confirm that the wall button still works, safety sensors still stop the door, and Home Assistant status updates match the physical door. Only mount the board after boring tests pass. A clean enclosure should be the last step, not the first.
Where to mount the ratgdo enclosure
The ratgdo 32 compatible holster enclosure has screw holes, zip-tie mounting points, a snap-on lid, and VHB tape for securing the board to the base. That makes it useful near the opener because you can keep the board covered while still being able to open the lid later for maintenance.
Mount it where the short terminal wires can reach without being stretched and where the USB power cable is not dangling near the rail, chain, belt, or moving door. Leave enough slack to remove the lid. Avoid burying it behind storage bins; you will want access if you update firmware, change WiFi, or troubleshoot a sensor.
If the same wall has chargers, tools, and seasonal storage, keep the opener electronics separate from heavier garage storage. The RYOBI 40V battery wall mount belongs on a tool wall, not beside low-voltage opener terminals, but it can help clean up the rest of the garage while the ratgdo board gets its own enclosure.
Common setup mistakes
- Using a charge-only USB cable for firmware flashing.
- Skipping the firmware step and trying to debug wiring first.
- Working on opener terminals while the opener is still plugged in.
- Assuming European Security+ 2.0 wiring is the same as North American wiring.
- Leaving the board loose on the opener after a successful test.
- Building automations before confirming obstruction sensors and wall controls still work normally.
Recommended install order
- Identify the opener model, learn-button color, and terminal layout.
- Match your ratgdo board revision to the correct official wiring diagram.
- Flash ESPHome or HomeKit firmware from a computer with a data cable.
- Join the board to WiFi and confirm the web UI loads.
- Unplug the opener, wire ratgdo, then plug the opener back in.
- Power ratgdo over USB and confirm local status/control.
- Add it to Home Assistant or HomeKit.
- Mount the board inside the Worm Pop Labs enclosure once testing is done.
Useful references
- Official ratgdo wiring documentation
- ratcloud firmware installation guide
- ratcloud wiring guide
- ratcloud mounting notes
Related products on Amazon
- Home Assistant Green Smart Home Hub
- MHCOZY 1 Channel ZigBee Smart Relay Switch
- SONOFF Zigbee 3.0 USB Dongle Plus
FAQ
Does the Worm Pop Labs enclosure include the ratgdo board?
No. The enclosure listing is for the case and mounting materials. Buy and flash the ratgdo board separately.
Should I mount ratgdo before flashing it?
No. Flash firmware and confirm WiFi first. It is much easier to fix a driver, cable, or firmware issue at a desk than on a ladder.
Does ratgdo work without Home Assistant?
Yes, depending on firmware. ESPHome is a common Home Assistant path, while HomeKit firmware is useful for Apple Home setups.
Can I use ratgdo with a dry-contact opener?
Some dry-contact setups are supported, but position status requires limit switches. Without them, firmware may only be able to toggle the door.
Why use an enclosure at all?
A garage opener vibrates, collects dust, and sits near moving hardware. A covered case keeps the board mounted and protected after the wiring is proven.