There’s a specific kind of annoyance that comes from lying in bed, half-asleep, wondering if you actually locked the back door. Commercial smart locks promise to fix that, but they’re expensive, often tied to subscription apps, and sometimes overkill for a simple question: is this door open or closed? That’s exactly the gap a homemade ESPHome door sensor fills, and it’s one of the most satisfying small projects you can add to a growing smart home solution.
This guide walks through the entire process — the parts, the wiring, the configuration, and the small mistakes worth avoiding — written the way I’d actually explain it to a friend who just unboxed their first ESP board and isn’t quite sure where to start.
Why a DIY Door Sensor Is Worth Building
Store-bought door and window sensors work fine, but most of them lock you into a specific ecosystem, rely on proprietary hubs, or quietly stop receiving updates a few years after purchase. A DIY version built with ESPHome sidesteps all of that. You know exactly how it works, you can modify it whenever you want, and it plugs directly into Home Assistant without any middleman.
There’s also a cost angle that’s hard to ignore. A single commercial door sensor can run anywhere from fifteen to thirty dollars, and that adds up quickly if you’re covering every entry point in the house. The components for a DIY version typically cost a few dollars each, which means outfitting an entire home becomes realistic instead of something you keep putting off.
Beyond the savings, there’s something genuinely useful about knowing precisely how your smart home solution is built. When something doesn’t work the way you expect, you’re not stuck waiting on a support ticket — you can open the configuration file and see exactly what’s happening.
What You’ll Need
This project is intentionally simple, which makes it a great starting point if you’re new to ESPHome. Here’s the shopping list:
- An ESP8266 or ESP32 board (an ESP8266-based board like a Wemos D1 Mini works well here, since this project doesn’t need much processing power)
- A magnetic reed switch (the kind used in basic door and window alarms)
- Two jumper wires
- A small enclosure or double-sided tape, just to keep things tidy
- A USB cable for the initial flash
That’s genuinely it. No soldering is strictly required if you’re comfortable with a breadboard-style setup, though a permanent installation will hold up better over time with a couple of soldered connections.
Step 1: Understand How a Reed Switch Works
Before touching any code, it helps to understand the actual mechanism. A reed switch has two thin metal contacts inside a small glass or plastic housing. When a magnet gets close — mounted on the door itself — those contacts touch and complete a circuit. Move the magnet away by opening the door, and the circuit breaks.
This is the same basic idea behind almost every commercial door sensor on the market. The only difference here is that instead of feeding that signal into a proprietary hub, you’re feeding it directly into an ESP board that reports the status straight to Home Assistant.
Step 2: Wire the Reed Switch to Your ESP Board
The wiring for this project is refreshingly simple:
- Connect one wire from the reed switch to a GPIO pin on your ESP board (GPIO 4 or GPIO 5 are common, easy-to-reach choices).
- Connect the other wire from the reed switch to a ground (GND) pin.
That’s the entire circuit. There’s no need for resistors in most setups, since ESPHome can handle the pull-up configuration in software, which we’ll cover in the next step.
Once wired, take a moment to physically test the connection with a multimeter if you have one — touching the magnet to the switch should show continuity, and moving it away should break that connection. Catching a wiring issue now saves a frustrating debugging session later.
Step 3: Write the ESPHome Configuration
This is where the project really comes together. Open the ESPHome dashboard (through the Home Assistant add-on or the standalone ESPHome tool) and create a new device. After entering your Wi-Fi credentials, you’ll add a binary sensor block that tells the board what the reed switch is and how to interpret it.
In plain terms, the configuration needs to specify:
- The GPIO pin the switch is connected to
- That the pin should use an internal pull-up resistor
- The sensor’s device class, set to “door,” which tells Home Assistant to display it correctly with proper icons and logic
- A short name, like “Back Door Sensor,” so it’s easy to identify later
ESPHome’s documentation includes a ready-made example for exactly this kind of binary sensor, so there’s rarely a need to write the block entirely from memory. Copy the example, adjust the pin number and name to match your setup, and you’re most of the way there.
Step 4: Flash the Firmware
With the configuration saved, connect your ESP board to your computer via USB and flash the firmware for the first time. ESPHome will compile everything in the background and upload it directly to the board. This first flash requires a physical USB connection, but every future update can be pushed wirelessly over your home network, which makes ongoing tweaks far less of a hassle.
Once the flash finishes and the board reconnects to Wi-Fi, it should show up automatically in Home Assistant within a minute or two, ready to be added as a new device.
Step 5: Test It Thoroughly Before Mounting
It’s tempting to immediately stick the sensor to the door frame and call it done, but a few minutes of testing first saves headaches later. Open and close the door a handful of times while watching the entity’s status update in Home Assistant. Confirm that:
- The state changes reliably every single time, with no missed triggers
- There’s no noticeable delay between the physical action and the state update
- The reading stays stable even if you gently wiggle the wires, simulating everyday vibration
Once you’re confident it’s working consistently, mount the magnet on the door itself and the sensor body on the frame, keeping them aligned as closely as possible when the door is closed. A gap that’s too wide is one of the most common reasons a freshly built sensor seems unreliable.
Turning a Simple Sensor Into Real Automation
A door sensor by itself is useful, but its real value comes from what you build around it. Once it’s reporting reliably into Home Assistant, a few automation ideas worth considering include:
- A notification if a door is left open for more than a set number of minutes, especially useful for exterior doors during colder months
- An automatic light trigger that turns on a hallway or porch light the moment the door opens after sunset
- A security layer that sends an alert if any door opens while an “Away” mode is active
- An energy-saving trigger that pauses the HVAC system temporarily if an exterior door stays open, preventing wasted heating or cooling
Each of these small automations adds practical value to your smart home solution without requiring anything more than the sensor you’ve already built.
Common Mistakes to Avoid
Placing the magnet too far from the switch. Reed switches have a limited detection range, and even a small gap can cause missed triggers. Test the actual distance before finalizing placement.
Forgetting to secure the wiring. Loose connections are one of the most common causes of “phantom” open or closed readings. A drop of hot glue or a small enclosure goes a long way toward long-term reliability.
Skipping the pull-up resistor setting. Without it, the sensor’s readings can become erratic or unreliable, especially on longer wire runs.
Choosing an inconvenient GPIO pin. Some pins on ESP boards have special functions during boot and can cause issues if used for external sensors. Sticking to well-documented, commonly used pins avoids unnecessary troubleshooting.
Not labeling devices clearly. As your smart home solution grows to include multiple sensors, vague names like “Sensor 1” become confusing fast. A few extra seconds spent naming devices clearly pays off later.
Expanding the Project
Once you’ve built one door sensor, the same basic principle applies to windows, cabinets, mailboxes, or even a garage side door. Because each sensor costs so little to build, it becomes realistic to cover every entry point in the house rather than just the one or two spots a commercial kit might include.
For those wanting to go a step further, combining a door sensor with a small buzzer or LED indicator creates a simple, self-contained alert system that works even if Home Assistant is briefly unavailable — a nice safety net for a fully local smart home solution.
In Conclusion
Building a smart door sensor with ESPHome is one of those projects that feels almost too simple once it’s finished, yet it delivers real, everyday value. It’s inexpensive, genuinely educational, and instantly useful the moment it’s mounted. More importantly, it’s a great entry point into understanding how ESPHome and Home Assistant work together, setting the stage for more ambitious projects down the road.
If you’ve been thinking about dipping a toe into DIY home automation, this is a solid place to start. It costs very little, teaches you the fundamentals, and adds a small but meaningful piece to a smart home solution that’s entirely your own — built exactly the way you want it, without relying on anyone else’s app, cloud service, or subscription plan.