Home Assistant
Install the integration, restart Home Assistant, then add it. The dialog shows a 6-digit code. Type that code on the Allow page. Each shared entity is a real sensor.
YOUR SIGNALS / YOUR RULES
Give Fizz more ways to understand your world.
ABOUT FIVE MINUTES AFTER YOU SIGN IN
Sign in to create the sensor and copy its key. Create an account or sign in. A new account has to confirm its email first.
This stores a reading on a real sensor. It is not a sample stream. Sample streams are simulated and labeled Simulated. Phone motion needs a separate permission, and Home Assistant needs an install and a restart, so this curl is the shortest path that works today.
curl -X POST https://fizzlayer.com/api/ingest \
-H 'Authorization: Bearer YOUR_SENSOR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"sensor_id":"YOUR_SENSOR_ID","event_id":"first-reading","metrics":{"temperature_c":21.5}}'Phone-call alerts and phone approvals are on paid plans only. Tinkerer and Pro share one monthly call cap for those calls. Tinkerer includes 20 calls a month and Pro includes 100. Enterprise is unlimited unless a contract sets a cap. The cap resets on the first of each month (UTC). Hobbyist ($0) includes dashboard and webhook alerts. Email alerts are included on every plan, including Hobbyist, and the dashboard shows email only when mail is configured. On fizzlayer.com that choice is hidden.
ALSO AVAILABLE
Install the integration, restart Home Assistant, then add it. The dialog shows a 6-digit code. Type that code on the Allow page. Each shared entity is a real sensor.
The sensors stack runs from two published images, with no repository checkout. The gateway is a separate Docker compose file in the repository, and there is no published gateway image. Chat, voice, phone calls, and card checkout stay off until you add them.
WHAT THE SENSOR TYPES ACCEPT
A Water sensor accepts flow_l_min from 0 to 200 and a true or false leak flag. A threshold shows on the dashboard when a reading crosses the limit you set.
Fizzlayer is not a safety system. Never rely on it alone to protect people or property.
A Temperature sensor accepts temperature_c from −100 to 200. The same sensor can watch a server closet or a cold room. The alert appears on the dashboard.
Fizzlayer is not a safety system. Never rely on it alone to protect people or property.
A Gas sensor accepts concentration_ppm from 0 to 10,000 and a true or false alarm flag. It stores those readings beside a detector you already have. It does not replace that detector.
Fizzlayer is not a safety system. Never rely on it alone to protect people or property.
Phone-call alerts for these are on paid plans only. Tinkerer and Pro share one monthly call cap with phone approvals. Tinkerer includes 20 calls a month and Pro includes 100. Enterprise is unlimited unless a contract sets a cap. The cap resets on the first of each month (UTC). Hobbyist ($0) includes dashboard and webhook alerts. Email alerts are included on every plan, including Hobbyist, and the dashboard shows email only when mail is configured. On fizzlayer.com that choice is hidden.
PAIR A DEVICE
Connect a Raspberry Pi or Linux computer as a live sensor. Enter the code from fizz pair below, then approve the connection in your device terminal.
Open a terminal on your Raspberry Pi or Linux computer and run:
Run this command on the same device. Keep the terminal open.
Enter the code below. Codes expire after 15 minutes.
Submit the code here, then return to the device terminal. Check the account name and approve the request to finish connecting. You can also ask a connected agent to claim the code.
After approval, run this on your device to stream CPU temperature, load, memory, and disk usage where available:
fizz run --every 60Your device appears as a Custom sensor on the Sensors page. Keep the command running to send a reading every minute. fizz run --stream --every 15 keeps one WebSocket open, fizz send --mqtt publishes MQTT, and fizz tail prints live readings. Those commands read addresses from GET /api/stream. Hosted MQTT is WebSocket only; there is no TCP port 1883.
Using an ESP32 or another microcontroller? Add a sensor below as a Real device to get its own API key. To connect a phone, add a Phone sensor as a Real device to get a link to open on it.
HOME ASSISTANT
Bring temperature, humidity, power, door, and leak sensors from a Home Assistant install into this workspace. Home Assistant pushes readings out, so the install can stay off the public internet. Each entity you share counts toward your plan's device limit.
Fizzlayer is not a safety system. Never rely on it alone to protect people or property.
Home Assistant needs the Fizzlayer integration before it can be added. Without it, Add integration shows "This integration does not support configuration via the UI." This opens HACS, or the Marketplace on Home Assistant 2026.11 and newer, and adds this repository as an Integration.
Restart Home Assistant after the install finishes. The next step does not work until you do.
After the restart, add Fizzlayer. The first time, My Home Assistant asks you to confirm your instance URL. The dialog title and the pairing-code field show a 6-digit code. Open the Allow page from the link in that dialog. Sign in if you need to. The page names this install and its version. Type the code from the Home Assistant dialog, then choose Allow. A code from a message is not enough, and you never copy a device token. Then pick the entities to share. Temperature, humidity, power, door, and leak sensors start selected.
Clone the repository and copy custom_components/fizzlayer into your Home Assistant config's custom_components folder. /config is that folder's parent on Home Assistant OS, Supervised, and the official container. Restart, then use Add integration above.
git clone --depth 1 https://github.com/fizzlayer/fizzlayer.git
mkdir -p /config/custom_components
cp -a fizzlayer/custom_components/fizzlayer /config/custom_components/Home Assistant in Docker, with the container named homeassistant:
git clone --depth 1 https://github.com/fizzlayer/fizzlayer.git
docker exec homeassistant mkdir -p /config/custom_components
docker cp fizzlayer/custom_components/fizzlayer homeassistant:/config/custom_components/fizzlayer
docker restart homeassistantIf your config directory is not /config, copy the folder into that directory's custom_components instead. Add integration shows a 6-digit code in the dialog title and in the pairing-code field, including when Advanced Mode is on. The link in that dialog opens the Allow page for fizzlayer.com. The screen also shows the integration version.
Home Assistant shows a 6-digit code in the dialog title and in the pairing-code field. Open the Allow page from the link in that dialog, type the code, then choose Allow. A code from a message is not accepted. The screen also shows the integration version.
01 / EXPAND FIZZ
02 / YOUR SENSORS
No sensors yet. Pair a device above, add a real sensor, or add a sample stream to explore.
VOICE FROM YOUR PHONE
03 / OPEN API
Add a sensor as a real device, or switch a sample sensor to API mode. Fizzlayer shows its key once, then accepts JSON readings over HTTPS. Each sensor has its own key so you can rotate or revoke it independently. Copy the sensor_id from its card above. The same key can hold a WebSocket or MQTT-over-WebSocket connection; GET /api/stream returns those addresses. There is no plain MQTT TCP port.
curl -X POST https://fizzlayer.com/api/ingest \
-H 'Authorization: Bearer YOUR_SENSOR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"sensor_id":"YOUR_SENSOR_ID","event_id":"sample-001","metrics":{"temperature_c":27.4}}'