Talk to Home Assistant from Alexa — locally, with no cloud.
FauxMo lets an Amazon Echo control Home Assistant directly over your local network. There's no Nabu Casa subscription, no Alexa skill, no account linking and nothing to expose to the internet.
Pick the entities you want Alexa to see (lights, switches, input booleans, scenes and scripts) and FauxMo presents each one to Alexa as a Belkin WeMo smart plug. Because scripts are supported, any custom action you build in Home Assistant can be triggered by voice: create a script called "Movie Night" and say "Alexa, turn on Movie Night". You can also add these devices to Alexa routines.
FauxMo is a friendlier replacement for Home Assistant's built-in Emulated Hue:
- Set up entirely in the UI. No YAML, and changes apply without a restart.
- Works on any port. Emulated Hue needs port 80, which often clashes with NGINX or other add-ons. FauxMo uses a configurable port range (50000+ by default).
- Custom names per entity. Choose exactly what Alexa calls each device.
Based on the fauxmo project by Nathan Henrie, originally forked from makermusings/fauxmo.
+----------+ SSDP/UDP 1900 +-------------------------+
| | -----------------> | SSDP Responder |
| Alexa | <----------------- | (upnp.py) |
| Echo | one response per | responds with one entry |
| | WeMo device | per entity |
| | +------------+------------+
| | GET /setup.xml | per-device
| | --------------------------------+ TCP ports
| | POST /upnp/control/basicevent1 | (50000+)
| | <-------------------------------+
+----------+ SOAP responses +------------+------------+
| WeMo Device Servers |
| (wemo_api.py) |
| one aiohttp server per |
| exposed entity |
+------------+------------+
|
calls HA services
(turn_on / turn_off)
|
v
+-------------------------+
| Home Assistant |
| entity states |
+-------------------------+
- SSDP discovery — A UDP responder on port 1900 answers Alexa's M-SEARCH broadcasts. Each registered entity gets its own SSDP response advertising its individual HTTP server location.
- Per-entity WeMo servers — Each exposed entity runs its own
aiohttp HTTP server on a dedicated port (base port + deterministic
offset). Alexa fetches
GET /setup.xmland sends SOAP commands toPOST /upnp/control/basicevent1. - Entity control — On/off SOAP commands are translated to
homeassistant.turn_on/homeassistant.turn_offservice calls (scenes usescene.turn_on; scene turn_off is a no-op).
Alexa only talks to an emulated Philips Hue bridge on port 80, which conflicts with other services (e.g. NGINX, another web server). Alexa reaches emulated Belkin WeMo devices on whatever port they advertise, so FauxMo gives each entity its own port in a configurable range: no port 80 and no reverse proxy needed.
input_boolean, light, scene, script, switch
FauxMo supports up to 255 exposed entities per installation.
On Home Assistant 2026.11 or later:
- Open Marketplace in Home Assistant and search for FauxMo, or click the button above.
- Click Download, then restart Home Assistant.
- Open HACS and search for FauxMo, or click the button above.
- Click Download, then restart Home Assistant.
Copy custom_components/fauxmo/ into your Home Assistant
config/custom_components/ directory. Restart Home Assistant.
After installation, add the integration via the UI:
Settings → Devices & Services → Add Integration → FauxMo
| Option | Default | Description |
|---|---|---|
| Base port | 50000 | Starting TCP port. Each entity is assigned a port in the range [base_port, base_port + 255). |
Open the integration's Options to pick which entities to expose and set custom Alexa-visible names:
- Select entities from the supported domains (max 255).
- Set a custom name for each (or leave blank to use the entity's friendly name).
- Save. Changes apply immediately — no restart required.
custom_components/fauxmo/
├── __init__.py # Integration lifecycle: setup, unload, options update
├── config_flow.py # Config flow UI (setup + options)
├── const.py # Constants (ports, domain, WeMo protocol values)
├── diagnostics.py # Diagnostic data export
├── manifest.json # HA integration manifest
├── quality_scale.yaml # HA quality scale checklist
├── store.py # Persistent per-entity activity tracking
├── strings.json # Localisation source strings
├── translations/
│ └── en.json # English translations
├── upnp.py # SSDP/UPnP discovery responder
└── wemo_api.py # WeMo device servers (one per entity)
tests/components/fauxmo/
├── conftest.py # Shared fixtures
├── test_config_flow.py
├── test_wemo_api.py
├── test_init.py
├── test_store.py
└── test_upnp.py
- Per-entity ports — Each entity gets a deterministic port
(
base_port + sum(ord(c) for c in entity_id) % 255), with collision resolution. No port 80 dependency. - Deterministic serials — Device serial numbers are derived from entity names (matching the original fauxmo algorithm) so they remain stable across restarts.
- No polling — State is read from HA at SOAP request time; SSDP
uses UDP multicast. Classification:
local_push. - Debounce — A 300 ms debounce window prevents duplicate commands from multiple Alexa devices responding simultaneously.
- Activity tracking —
store.pyrecords per-entityfirst_discoveredandlast_controlledtimestamps, viewable in the diagnostics panel. - Auto-reload on port change — Changing the base port in the options flow triggers a full integration reload.
Because FauxMo emulates Belkin WeMo switches on your network, Home Assistant's built-in WeMo integration will detect them and show a discovery notification asking you to set up "Belkin WeMo". Ignore and dismiss this notification — these are your own emulated devices, not real WeMo hardware. You can click Ignore on the notification to prevent it from appearing again.
If Alexa doesn't find your devices, verify:
- SSDP reachable — Check HA logs for M-SEARCH activity from Alexa's IP.
- Device servers running — In the diagnostics panel, confirm
device_servers_runningmatches your entity count. - setup.xml reachable —
curl http://<HA_IP>:<device_port>/setup.xmlshould return Belkin device XML. - Same subnet — Alexa and HA must be on the same LAN subnet (SSDP multicast doesn't cross routers).
- Firewall — Ensure UDP 1900 and the device ports (default 50000–50254) are not blocked between Alexa and HA.
pytest tests/components/fauxmo/ -v# configuration.yaml
logger:
logs:
custom_components.fauxmo: debugProtocol implementation inspired by fauxmo by Nathan Henrie, originally forked from makermusings/fauxmo.
This project is released under the MIT License. It includes code derived from fauxmo (original work copyright (c) 2015 Maker Musings, modified work copyright 2015 Nathan Henrie), also under the MIT License.