OctoPrint
octoprint
OctoPrint is a web interface for your 3D printer. This is the main integration to integrate OctoPrint sensors.
In Apple Home through HomeKit Bridge
What HomeKit Bridge makes of each kind of entity this integration creates, read from its source code. A device only gets the ones that apply to it.
| Entity | Shows up as | Note |
|---|---|---|
camera | Camera | Needs its own HomeKit Bridge in accessory mode |
binary_sensor | Sensor (motion, contact, leak, smoke…) | |
sensor | Sensor (temperature) | |
button | Button (as a switch) |
1 report below say how a device from this integration behaves in the Home app.
What people report
OctoPrint works for printer status and MJPEG cameras. Users report it needs the discovery plugin, basic-auth URLs broke, and HLS/WebRTC cameras aren't supported.
- Works1
- Partly works1
- Not working1
- Requested1
| Device | In Home Assistant | In Apple Home | What they said | Source |
|---|---|---|---|---|
| OctoPrint percent-complete sensor | Works | Partly in Home Percent sensor wrongly appeared as a humidity sensor | Any sensor with % unit shows as humiditySaved copy… defined in entities. Problem-relevant `configuration.yaml` entries and (fill out even if it seems unimportant): [code] [code] Additional information: Octoprint % complete was included as a humidity sensor in homekit as well with the above config. Excerpt saved from GitHub on 2026-10-23. | Issue #13597 · 2018-03 |
| OctoPrint server (with discovery plugin disabled) | Partly works | Setup fails when the UPnP discovery plugin is disabledSaved copyThe problem This is basically a reopen of https://github.com/home-assistant/core/issues/160192 Upnp discovery may not be available in all the cases besides octo4a. And current integration does not work without it ### What version of Home Assistant Core has the issue? core-2025.12.5 ### What was the last working version of Home Assistant Core? _No response_ ### What type of installation are you running? Home Assistant Container ### Integration causing the issue Octoprint ### Link to integration documentation on our website https://www.home-assistant.io/integrations/octoprint ### Diagnostics … Excerpt saved from GitHub on 2026-10-23. | Issue #160512 · 2026-01 | |
| OctoPrint with basic auth | Not working | Camera setup failed with credentials in URL after yarl changeSaved copyThe problem After installing update, octoprint showed 0 entries, after checking the logs found this message `Error while setting up octoprint platform for camera Traceback (most recent call last): File "/usr/src/homeassistant/homeassistant/helpers/entity_platform.py", line 361, in _async_setup_platform await asyncio.shield(awaitable) File "/usr/src/homeassistant/homeassistant/components/octoprint/camera.py", line 40, in async_setup_entry OctoprintCamera( File "/usr/src/homeassistant/homeassistant/components/octoprint/camera.py", line 66, in init device_info=coordinator.device_info, … Excerpt saved from GitHub on 2026-10-23. | Issue #128264 · 2024-10 | |
| OctoPrint HLS/WebRTC camera | Requested | Only MJPEG cameras supported; HLS and WebRTC PR was closedSaved copyProposed change Octoprint has for a couple years now supported HLS and WebRTC camera streams, in addition to the original MJPEG. The current Home Assistant integration, however, still assumes that all streams are MJPEG. This PR adds support for HLS and WebRTC streams. A previous version of this PR (#107044) attempted to build on top of `GenericCamera`. Intervening changes to how WebRTC is handled, however, made that less helpful, so now both the HLS and WebRTC implementations derive directly from `Camera`. The `async_camera_image()` implementation is still based on that of `GenericCamera`, … Excerpt saved from GitHub on 2026-10-23. | PR #157215 · 2025-11 |
Gathered from GitHub issues, pull requests, discussions and docs, and from r/homeassistant. These are individual reports, so check the linked thread and the date before you buy.
How it connects
Local polling
Talks to the device on your network, asking it for updates every so often.
Found automatically over
- SSDP/UPnP
- Bonjour (zeroconf)
Details
| Installs (analytics) | 8,403 (1.19%) |
|---|---|
| Added in | Home Assistant 0.19 |
| Set up in the UI | Yes |
| Maintainers | @rfleming71 |
In ReReHome
Whatever HomeKit Bridge shares reaches Apple Home as normal HomeKit accessories behind your Home Assistant bridge, so ReReHome shows and controls them like any other.
Bridges get their own settings page listing the accessories behind them.
