diff --git a/docs/.vitepress/usecase.en.ts b/docs/.vitepress/usecase.en.ts
index 7475f3cc73..f022613b15 100644
--- a/docs/.vitepress/usecase.en.ts
+++ b/docs/.vitepress/usecase.en.ts
@@ -421,6 +421,10 @@ export const useCaseSidebar: DefaultTheme.Sidebar = {
text: "FlareSolverr",
link: "/use-cases/flaresolverr",
},
+ {
+ text: "Home Assistant",
+ link: "/use-cases/home-assistant",
+ },
]
},
],
diff --git a/docs/.vitepress/usecase.zh.ts b/docs/.vitepress/usecase.zh.ts
index 314e102c25..250614d23c 100644
--- a/docs/.vitepress/usecase.zh.ts
+++ b/docs/.vitepress/usecase.zh.ts
@@ -421,6 +421,10 @@ export const useCaseSidebar: DefaultTheme.Sidebar = {
text: "FlareSolverr",
link: "/zh/use-cases/flaresolverr",
},
+ {
+ text: "Home Assistant",
+ link: "/zh/use-cases/home-assistant",
+ },
],
},
],
diff --git a/docs/public/images/manual/use-cases/home-assistant-add-hacs.png b/docs/public/images/manual/use-cases/home-assistant-add-hacs.png
new file mode 100644
index 0000000000..155c43bc6a
Binary files /dev/null and b/docs/public/images/manual/use-cases/home-assistant-add-hacs.png differ
diff --git a/docs/public/images/manual/use-cases/home-assistant-address-bar.png b/docs/public/images/manual/use-cases/home-assistant-address-bar.png
new file mode 100644
index 0000000000..08acde86a8
Binary files /dev/null and b/docs/public/images/manual/use-cases/home-assistant-address-bar.png differ
diff --git a/docs/public/images/manual/use-cases/home-assistant-dashboard-areas.png b/docs/public/images/manual/use-cases/home-assistant-dashboard-areas.png
new file mode 100644
index 0000000000..d1fcacea47
Binary files /dev/null and b/docs/public/images/manual/use-cases/home-assistant-dashboard-areas.png differ
diff --git a/docs/public/images/manual/use-cases/home-assistant-dashboard-fav.png b/docs/public/images/manual/use-cases/home-assistant-dashboard-fav.png
new file mode 100644
index 0000000000..30c810bce0
Binary files /dev/null and b/docs/public/images/manual/use-cases/home-assistant-dashboard-fav.png differ
diff --git a/docs/public/images/manual/use-cases/home-assistant-discover-device.png b/docs/public/images/manual/use-cases/home-assistant-discover-device.png
new file mode 100644
index 0000000000..19a0bc0561
Binary files /dev/null and b/docs/public/images/manual/use-cases/home-assistant-discover-device.png differ
diff --git a/docs/public/images/manual/use-cases/home-assistant-generic-camera.png b/docs/public/images/manual/use-cases/home-assistant-generic-camera.png
new file mode 100644
index 0000000000..d138555a1f
Binary files /dev/null and b/docs/public/images/manual/use-cases/home-assistant-generic-camera.png differ
diff --git a/docs/public/images/manual/use-cases/home-assistant-hacs-added.png b/docs/public/images/manual/use-cases/home-assistant-hacs-added.png
new file mode 100644
index 0000000000..61533f7bf1
Binary files /dev/null and b/docs/public/images/manual/use-cases/home-assistant-hacs-added.png differ
diff --git a/docs/public/images/manual/use-cases/home-assistant-hacs-integrations.png b/docs/public/images/manual/use-cases/home-assistant-hacs-integrations.png
new file mode 100644
index 0000000000..dc5fea0178
Binary files /dev/null and b/docs/public/images/manual/use-cases/home-assistant-hacs-integrations.png differ
diff --git a/docs/public/images/manual/use-cases/home-assistant-hacs-search.png b/docs/public/images/manual/use-cases/home-assistant-hacs-search.png
new file mode 100644
index 0000000000..6b7fa9dde1
Binary files /dev/null and b/docs/public/images/manual/use-cases/home-assistant-hacs-search.png differ
diff --git a/docs/public/images/manual/use-cases/home-assistant-new-folder.png b/docs/public/images/manual/use-cases/home-assistant-new-folder.png
new file mode 100644
index 0000000000..431150b3b5
Binary files /dev/null and b/docs/public/images/manual/use-cases/home-assistant-new-folder.png differ
diff --git a/docs/public/images/manual/use-cases/home-assistant-open-in-new.png b/docs/public/images/manual/use-cases/home-assistant-open-in-new.png
new file mode 100644
index 0000000000..46802c8a69
Binary files /dev/null and b/docs/public/images/manual/use-cases/home-assistant-open-in-new.png differ
diff --git a/docs/public/images/manual/use-cases/home-assistant-restart.png b/docs/public/images/manual/use-cases/home-assistant-restart.png
new file mode 100644
index 0000000000..0ec30fcfd5
Binary files /dev/null and b/docs/public/images/manual/use-cases/home-assistant-restart.png differ
diff --git a/docs/public/images/manual/use-cases/home-assistant-welcome.png b/docs/public/images/manual/use-cases/home-assistant-welcome.png
new file mode 100644
index 0000000000..e548a450f7
Binary files /dev/null and b/docs/public/images/manual/use-cases/home-assistant-welcome.png differ
diff --git a/docs/public/images/manual/use-cases/home-assistant.png b/docs/public/images/manual/use-cases/home-assistant.png
new file mode 100644
index 0000000000..fa70bd1494
Binary files /dev/null and b/docs/public/images/manual/use-cases/home-assistant.png differ
diff --git a/docs/use-cases/home-assistant.md b/docs/use-cases/home-assistant.md
new file mode 100644
index 0000000000..0bf26376a8
--- /dev/null
+++ b/docs/use-cases/home-assistant.md
@@ -0,0 +1,212 @@
+---
+outline: [2, 4]
+description: Learn how to install Home Assistant on Olares, integrate your smart home devices, and build a dashboard to control your home server.
+head:
+ - - meta
+ - name: keywords
+ content: Olares, Home Assistant, Dahua, IP camera, smart home, RTSP, HACS
+app_version: "1.0.16"
+doc_version: "1.0"
+doc_updated: "2026-06-08"
+---
+
+# Build your smart home hub with Home Assistant
+
+Home Assistant is an open-source home automation platform that brings together your smart home devices.
+
+This guide walks you through installing Home Assistant on Olares, connecting a Dahua IP camera, and monitoring live security feeds directly from your Olares.
+
+## Learning objectives
+
+In this guide, you will learn how to:
+
+- Install Home Assistant from the Olares Market.
+- Set up your initial Home Assistant profile.
+- Connect a Dahua camera using the generic RTSP stream or the advanced HACS integration.
+- Monitor the live camera feed from your Home Assistant dashboard.
+
+## Prerequisites
+
+- You have a Dahua IP camera powered on and connected to the same local network as your Olares device.
+- You have the administrator username and password for the camera.
+
+## Install Home Assistant
+
+1. Open Market, and search for "Home Assistant".
+
+ 
+
+2. Click **Get**, and then click **Install**. Wait for the installation to finish.
+
+## Set up your account
+
+Set up your local administrator account to begin using your Home Assistant dashboard.
+
+1. Open Home Assistant from the Launchpad.
+2. On the welcome screen, select your preferred language, and then select **Create my smart home**.
+
+ 
+
+3. Enter the required profile information, including the username and password, and then click **Create account**.
+4. Follow the remaining on-screen prompts to complete the setup.
+5. Log in to the Home Assistant dashboard using your new credentials.
+
+## Prepare your Dahua camera
+
+To allow Home Assistant to discover and communicate with the camera, you must locate its network details via the Dahua web interface.
+
+### Step 1. Obtain the camera IP address
+
+1. Download the device discovery tool according to your operating system:
+
+ - Windows: Go to the [Dahua Support website](https://support.dahuasecurity.com/en/toolsDownloadDetails?IsDpValue=Q93jdSLr94chjRuQ1y%2FcQQ%3D%3D) and download the **ConfigTool**.
+ - macOS: Open the App Store and install the **CCTV Super Tool**. This guide uses the CCTV Super Tool.
+
+2. Open CCTV Super Tool, and then click **Scan LAN**.
+3. When prompted to allow the application to find devices on your local networks, select **Allow**.
+4. Click **Scan LAN**. The camera device is discovered and listed.
+
+ 
+
+5. Locate your camera in the discovered device list, and then note down the IP address. For example, `192.168.50.43`.
+
+### Step 2. Get the camera ports
+
+1. From the discovered device list, click your device, and then select **Open device website**.
+2. Enter the username and password. The default is usually `admin` for both, which you must change on your first login.
+3. Go to **Network** > **Port**.
+4. Note down the HTTP port (usually `80`) and RTSP port (usually `554`).
+
+## Add the camera to Home Assistant
+
+Integrate your camera using one of the following methods:
+- **Generic Camera integration** for a quick, basic video feed.
+- **HACS integration** for deeper device control and advanced features.
+
+### Method A: Generic Camera (RTSP) integration
+
+The Generic Camera integration uses the camera's Real-Time Streaming Protocol (RTSP) stream URL to display video.
+
+#### Step 1. Add the Generic Camera integration
+
+1. In Home Assistant, go to **Settings** > **Devices & services**.
+2. Click **Add integration**.
+3. Search for "Generic Camera" and select it.
+4. In the **Stream source URL** field, construct and enter your RTSP address. Dahua cameras usually use the following format:
+
+ ```
+ rtsp://{username}:{password}@{camera_ip}:{rtsp_port}/cam/realmonitor?channel=1&subtype=1
+ ```
+
+ Where,
+ - `username`: The camera's web interface login username.
+ - `password`: The camera's web interface login password.
+ - `camera_ip`: The camera's IP address.
+ - `rtsp_port`: The RTSP port number of the camera (usually `554`).
+ - `subtype=1`: The stream quality subtype. Use `0` for the main (high-resolution) stream, or `1` for the sub (low-resolution) stream.
+
+ For example:
+
+ ```
+ rtsp://admin:12345Olares@192.168.50.43:554/cam/realmonitor?channel=1&subtype=1
+ ```
+
+ 
+
+5. Keep the remaining default settings, and then click **Submit**.
+6. Wait for the preview to load.
+7. After confirming the video feed works, click **Submit**.
+
+#### Step 2. Add the camera to your dashboard
+
+1. Select **Overview** from the left sidebar.
+2. Click edit in the upper-right corner.
+3. From the **Favorite entities** list, select your camera device, and then click **Save**.
+
+ The live camera feed now appears on your dashboard in the **Favorites** section.
+
+ 
+
+4. Click the camera feed to open it in a separate window and view the real-time stream.
+
+### Method B: HACS integration
+
+The Home Assistant Community Store (HACS) allows you to download a dedicated, community-built Dahua integration for expanded functionality.
+
+#### Step 1. Download the HACS plugin
+
+1. Open your web browser and go to the [official GitHub repository of HACS](https://github.com/hacs/integration).
+2. Select **Releases** on the right side of the page.
+3. Locate the **Assets** section, and then download the latest `hacs.zip` file.
+4. Extract the downloaded `.zip` file on your local computer to access the `hacs` folder.
+
+#### Step 2. Upload HACS to Olares
+
+Use Olares Files to place the plugin in the correct system folder so Home Assistant reads it.
+
+1. Open the Files app from the Launchpad.
+2. Go to **Application** > **Data** > **homeassistant**.
+3. Create a new folder by clicking create_new_folder in the upper-right corner.
+
+ 
+
+4. Enter `custom_components` as the folder name, and then click **Create**.
+5. Double-click the newly created folder **custom_components**.
+6. Click drive_folder_upload in the upper-right corner, select **Upload folder**, and then upload the extracted `hacs` folder from your local computer.
+
+#### Step 3. Restart Home Assistant
+
+Restart Home Assistant for it to detect the newly uploaded `custom_components` folder.
+
+1. In Home Assistant, select **Settings** from the left sidebar, and then select **System**.
+2. Click power_settings_new in the upper-right corner.
+
+ 
+
+3. Select **Restart Home Assistant**, and then click **Restart**. Wait for the restart to complete.
+
+#### Step 4. Authorize and install HACS
+
+1. Go back to **Settings**, and then select **Devices & services**.
+2. Click **Add integration**.
+3. Search for **HACS**, and then select it from the list.
+
+ 
+
+4. Read the notices, select all the acknowledgment checkboxes, and then click **Submit**.
+5. In the **Wait for device activation** window, copy the provided authorization key, and then click the displayed link, such as https://github.com/login/device.
+6. Sign in with your GitHub account.
+7. Paste the authorization key you copied, and then click **Authorize hacs**.
+8. Return to Home Assistant. HACS now appears on the left sidebar and in the **Integrations** list.
+
+ 
+
+#### Step 5. Install and configure the Dahua integration
+
+1. Select **HACS** from the left sidebar, and then search for "dahua".
+
+ 
+
+2. Select the target device from the list, and then click **Download**.
+3. Go to **Settings** > **System**, and then restart Home Assistant again to apply the new integration.
+4. After restarting, select **Overview** from the left sidebar.
+5. Click add in the upper-right corner, and then select **Add device**.
+6. Search for the brand name "Dahua", and then select it from the result.
+7. In the **Add Dahua Camera** window, configure the device settings using the information you noted down earlier:
+
+ - **Username**: Enter the camera's web interface login username.
+ - **Password**: Enter the camera's web interface login password.
+ - **Address**: Enter the camera's IP address, that is, `192.168.50.43`.
+ - **Port**: Enter the HTTP port number, that is, `80`.
+ - **RTSP Port**: Enter the RTSP port number, that is, `554`.
+
+8. Keep the remaining settings as default, and then click **Submit**.
+9. Specify a name for the device, and then click **Submit**.
+10. Assign it to an area such as **Front door**, and then click **Finish**.
+
+#### Step 6. Monitor your device on the dashboard
+
+1. Select **Overview** from the left sidebar, and then locate your camera by its assigned area in the **Areas** section.
+2. Click the area to view the live feed and device controls.
+
+ 
diff --git a/docs/zh/use-cases/home-assistant.md b/docs/zh/use-cases/home-assistant.md
new file mode 100644
index 0000000000..d53e549a5d
--- /dev/null
+++ b/docs/zh/use-cases/home-assistant.md
@@ -0,0 +1 @@
+