From e183ae5ef69285f4072da41a9fcc5196e1fff113 Mon Sep 17 00:00:00 2001
From: Nicolas Mowen <nickmowen213@gmail.com>
Date: Sat, 11 Oct 2025 15:29:24 -0600
Subject: [PATCH] Add docs for HomeKit (#20435)

---
 docs/docs/integrations/homekit.md | 37 +++++++++++++++++++++++++++++++
 docs/sidebars.ts                  |  1 +
 2 files changed, 38 insertions(+)
 create mode 100644 docs/docs/integrations/homekit.md

diff --git a/docs/docs/integrations/homekit.md b/docs/docs/integrations/homekit.md
new file mode 100644
index 000000000..5954af41c
--- /dev/null
+++ b/docs/docs/integrations/homekit.md
@@ -0,0 +1,37 @@
+---
+id: homekit
+title: HomeKit
+---
+
+Frigate cameras can be integrated with Apple HomeKit through go2rtc. This allows you to view your camera streams directly in the Apple Home app on your iOS, iPadOS, macOS, and tvOS devices.
+
+## Overview
+
+HomeKit integration is handled entirely through go2rtc, which is embedded in Frigate. go2rtc provides the necessary HomeKit Accessory Protocol (HAP) server to expose your cameras to HomeKit.
+
+## Setup
+
+All HomeKit configuration and pairing should be done through the **go2rtc WebUI**.
+
+### Accessing the go2rtc WebUI
+
+The go2rtc WebUI is available at:
+
+```
+http://<frigate_host>:1984
+```
+
+Replace `<frigate_host>` with the IP address or hostname of your Frigate server.
+
+### Pairing Cameras
+
+1. Navigate to the go2rtc WebUI at `http://<frigate_host>:1984`
+2. Use the `add` section to add a new camera to HomeKit
+3. Follow the on-screen instructions to generate pairing codes for your cameras
+
+## Requirements
+
+- Frigate must be accessible on your local network using host network_mode
+- Your iOS device must be on the same network as Frigate
+- Port 1984 must be accessible for the go2rtc WebUI
+- For detailed go2rtc configuration options, refer to the [go2rtc documentation](https://github.com/AlexxIT/go2rtc)
diff --git a/docs/sidebars.ts b/docs/sidebars.ts
index df32f2efd..09b639aa1 100644
--- a/docs/sidebars.ts
+++ b/docs/sidebars.ts
@@ -116,6 +116,7 @@ const sidebars: SidebarsConfig = {
         items: frigateHttpApiSidebar,
       },
       "integrations/mqtt",
+      "integrations/homekit",
       "configuration/metrics",
       "integrations/third_party_extensions",
     ],