Skip to content
Homebridge TestFlight
Roborock

Roborock Vacuum

homebridge-roborock-vacuum2 · v1.4.74

Local + cloudMatter

Adds Roborock robot vacuums to HomeKit with start/stop, pause and return-to-dock controls.

What it says it supports

Brands

  • Roborock

Devices it names

  • Roborock vacuums

Shows up in Apple Home as from its README

What people report

Supports Roborock vacuums including Matter accessories; maintainer fixed pause and return-to-dock for a Matter vacuum.

  • Works1
  • Partly works1
DeviceStatusWhat they saidSource
Roborock vacuum (roborock.vacuum.a15)WorksPause and dock failed on Matter accessory; fixed by maintainer after report.
Saved copy
Redacted diagnostic report homebridge-roborock-vacuum2 diagnostic report generatedAt: 2026-06-11T16:53:00.572Z pluginVersion: 1.4.57 nodeVersion: v24.16.0 token: present homeData: present cloudOnlyMode: disabled deviceCount: 2 device 1: Downtown Rock duid: 66xm...ni7Y serialNumber: R14N...1346 resolvedModel: roborock.vacuum.a15 productId: 1YYW18rpgyAJTISwb1NM91 online: true connectionStatus: Local connected connectionHint: The plugin has an active LAN TCP connection to this vacuum. localIp: 192.168.69.x discovery: discovered tcpState: connected markedRemote: false remoteReason: n/a …

Excerpt saved from GitHub on 2026-10-22.

Issue #12 · 2026-06
Roborock vacuum a15 (plugin config local test)Partly worksPlugin config local test fails after first run; still present on 1.4.66.
Saved copy
Redacted diagnostic report homebridge-roborock-vacuum2 diagnostic report generatedAt: 2026-07-08T15:00:43.335Z pluginVersion: 1.4.63 nodeVersion: v24.18.0 token: present homeData: present cloudOnlyMode: disabled deviceCount: 2 device 1: Downtown Rock duid: 66xm...ni7Y serialNumber: R14N...1346 resolvedModel: roborock.vacuum.a15 productId: 1YYW18rpgyAJTISwb1NM91 online: true connectionStatus: Local connected connectionHint: The plugin has an active LAN TCP connection to this vacuum. localIp: 192.168.69.x discovery: discovered tcpState: connected markedRemote: false remoteReason: n/a …

Excerpt saved from GitHub on 2026-10-22.

Issue #13 · 2026-07

Gathered from the plugin’s GitHub issues, pull requests, discussions, wiki and docs, and from r/homebridge. These are individual reports, so check the linked thread and the date before you buy.

How it connects

Local + cloud

Roborock app account with local TCP or cloud transport

You’ll need

  • Roborock app account

Compatibility

Verified by HomebridgeNo
Homebridge versions>=1.8.0 <3.0.0-0
Homebridge 2.0No
Node.js^18.20.4 || ^20.15.1 || ^22 || ^24 || ^26
Settings in Homebridge UIYes
MatterYes (uses the Homebridge 2 Matter API)
Platform nameRoborockVacuumPlatform
LicenseMIT

Community signals

Downloads a week68
Downloads a month608
GitHub stars0
Open issues1
Closed issues13
Last code push2026-10-17
Latest version1.4.74 (2026-10-17)
First published2026-04-11
Releases64

In ReReHome

Whatever this plugin publishes reaches Apple Home as a normal HomeKit accessory behind your Homebridge bridge, so ReReHome shows and controls it like any other.

Bridges get their own settings page listing the accessories behind them.

HomeKit services in its code

Found by scanning the published npm package. A plugin can register a service only for some devices.

  • Battery
  • Fanv2
  • Switch