FAQ
Short answers to the questions people ask most about ESP32, HomeKit and Matter builds.
Do I need Homebridge or a cloud account to use an ESP32 with Apple Home?
No. The HomeKit projects here put HomeKit firmware directly on the ESP32, and you add it in the Apple Home app like any other accessory. There is no bridge and no cloud service in between. The beginner guide walks through the whole path, from installing Docker to adding the accessory in Apple Home.
Which ESP32 board should I start with?
The beginner guides use an ESP32-WROOM-32D development board: it has USB built in and buttons, which makes the first flash easy. Its pinout guide lists every GPIO with its boot behaviour. Other boards, such as the C3, C6 and ESP8266, have their own pages in the guides.
Do I have to install ESP-IDF on my computer?
No. The guides run ESP-IDF inside Docker, using Espressif’s official espressif/idf image (the beginner guide pins v5.4). Your system stays clean and every build uses the same version. ESP32 HomeKit Development with ESP-IDF explains the setup.
Do I need to know how to code?
Some comfort with a terminal helps. These are real firmware projects, not no-code tools. The beginner guides explain each step slowly, including what Docker and ESP-IDF are. The Matter toolkit is more demanding: it works from the command line with ESP-IDF and C++ inside Docker, although a local wizard writes the build commands for you. New to all of this? Start here puts the guides in order.
Should I choose HomeKit or Matter?
HomeKit is Apple’s own protocol. Matter is a shared standard backed by Apple, Google, Amazon, Samsung and others, so one device can work across several ecosystems. This site covers both: HomeKit projects and esp32-matter, a toolkit with 69 buildable device types. The full comparison is in HomeKit or Matter for your ESP32. Read the next answer before choosing Matter for Apple Home.
Can I add an esp32-matter device to Apple Home?
Not through the normal consumer pairing flow. The toolkit generates a self-signed test attestation certificate. Home Assistant and the chip-tool CLI accept it, so a fully local setup with Home Assistant works today. Apple Home and Google Home check the certificate against their own list of trusted roots, so pairing there needs a real Vendor ID from the Connectivity Standards Alliance and a matching attestation chain, a certification the project cannot shortcut. For Apple Home today, use the HomeKit projects.
Which chips does the Matter toolkit support?
The classic ESP32 DevKit (WROOM-32) is the default target. The ESP32-C6 and several other Espressif chips (C2, C3, C5, C61, S3 and H2) are also supported. Details are in the esp32-matter write-up.
Where does the pinout data come from?
From the manufacturers’ own datasheets, and each guide is checked against them rather than copied from forum posts. If you spot a mistake, please tell me and include the guide and the pin.
How do I make a HomeKit setup label with a QR code?
A small open-source Python tool generates a full pairing label: QR code, setup code, MAC address and barcoded serials, as PNG or PDF. See the QR code guide.
How can I ask a question or report a problem?
Use the contact form. Say which guide or project you are on, what board you use and what you already tried, so the answer can be specific.