---
title: How to Set Up Lightwave with Home Assistant?
description: Learn how to connect your Lightwave account to Home Assistant. This guide covers setup, device discovery, and managing Lightwave devices within Home Assistant.
---
[Skip to content](https://support.lightwaverf.com/knowledge/how-to-set-up-lightwave-with-home-assistant#main-content)
Open main navigation
Close main navigation
How can we help you?
- There are no suggestions because the search field is empty.
1. [Help Center](https://support.lightwaverf.com/knowledge?hsLang=en)
2. [What do I need? & System Setup](https://support.lightwaverf.com/knowledge/what-do-i-need-system-setup?hsLang=en)
3. [Third Party Integrations](https://support.lightwaverf.com/knowledge/what-do-i-need-system-setup?hsLang=en#third-party-integrations)
# How to Set Up Lightwave with Home Assistant?
## This article outlines how to set up Lightwave with Home Assistant using the built-in integration. It covers the simple process of connecting your Lightwave account, enabling device discovery, and managing your smart home devices directly within Home Assistant.
Lightwave can be integrated into Home Assistant using a custom component called **Lightwave Smart**, allowing you to control your Smart Series and Connect Series devices directly from your Home Assistant dashboard.
**Warning: **This integration is community-driven, relying on contributions for ongoing development, enhancements, and documentation support.
### 🧩 What You’ll Need
1. A **Lightwave Link Plus** hub (L2)
2. A **Home Assistant** installation (local or cloud)
3. The **HACS** (Home Assistant Community Store) installed
4. Your **Lightwave account credentials**
---
#### 🔧 Step-by-Step Setup Guide
### Step 1: Install HACS (if not already set up)
HACS is the easiest way to manage custom integrations.
1. Go to **Settings \> Add-ons** in Home Assistant.
2. Follow the [official HACS install guide](https://hacs.xyz/docs/use/download/download/) to add it.
3. Once installed, restart Home Assistant.
---
### Step 2: Add the Lightwave Smart Integration
1. Go to **HACS \> Integrations**.
2. Click the three-dot menu (⋮) \> **Custom repositories**.
-png.png?width=670&height=173&name=Untitled%20design%20(30)-png.png)
3. Enter the following repo URL:
`https://github.com/LightwaveSmartHome/homeassistant-lightwave-smart`
- Set category to: `Integration`
4. Click **Add**, then search for **Lightwave Smart** under available integrations.
-png.png?width=670&height=207&name=Untitled%20design%20(31)-png.png)
5. Click **Download**, then restart Home Assistant when prompted.
-png.png?width=670&height=363&name=Untitled%20design%20(32)-png.png)
-png.png?width=670&height=469&name=Untitled%20design%20(33)-png.png)
**Note:** A restart of Home Assistant is required after downloading the integration.
-png.png?width=670&height=361&name=Untitled%20design%20(34)-png.png)
> 💡 The Lightwave Smart integration supports both **Smart Series** and **Connect Series** devices. It does not work with the original Link (LW930 & LW500) hub.
---
### Step 3: Add the Integration to Home Assistant
1. Go to **Settings \> Devices & Services**.
-png.png?width=670&height=361&name=Untitled%20design%20(35)-png.png)
2. Click **Add Integration**.
-png.png?width=670&height=424&name=Untitled%20design%20(36)-png.png)
3. Search for **Lightwave** and select **Lightwave Smart custom component**.
-png.png?width=670&height=424&name=Untitled%20design%20(37)-png.png)
4. Log in with your **Lightwave account** credentials when prompted.
5. You’ll see a confirmation window listing all discovered devices like switches, sockets, and dimmers. Assign each device to its appropriate **area** and click **Finish**.
---
### ✅ Your Lightwave Devices Are Now Live!
You can now:
- Toggle Lightwave devices from the dashboard
- Automate them with other Home Assistant devices
- View and organize entities from the **Devices** and **Entities** tabs
---
#### 🔁 Need to Update or Repair?
- To update the integration, return to **HACS \> Integrations** and re-download the latest version.
- If prompted for a restart, do so via **Settings \> System \> Restart**.
- For troubleshooting, visit **Developer Tools \> Logs**.
---
### 🧠 Tips for Success
- **Name your devices clearly** in the Lightwave app — this helps with Home Assistant recognition.
- If you encounter entity issues, re-run the setup or delete and re-add the integration.
- [What do I need? & System Setup](https://support.lightwaverf.com/knowledge/what-do-i-need-system-setup?hsLang=en#main-content)
- [Getting started on the Lightwave App](https://support.lightwaverf.com/knowledge/what-do-i-need-system-setup?hsLang=en#getting-started-on-the-lightwave-app)
- [Lighting](https://support.lightwaverf.com/knowledge/what-do-i-need-system-setup?hsLang=en#lighting)
- [Heating](https://support.lightwaverf.com/knowledge/what-do-i-need-system-setup?hsLang=en#heating)
- [Automations](https://support.lightwaverf.com/knowledge/what-do-i-need-system-setup?hsLang=en#automations)
- [Third Party Integrations](https://support.lightwaverf.com/knowledge/what-do-i-need-system-setup?hsLang=en#third-party-integrations)
- [FAQ's](https://support.lightwaverf.com/knowledge/what-do-i-need-system-setup?hsLang=en#faqs)
- [Advanced Features](https://support.lightwaverf.com/knowledge/what-do-i-need-system-setup?hsLang=en#advanced-features)
- [App Guidance & Automations](https://support.lightwaverf.com/knowledge/app-guidance-automations?hsLang=en#main-content)
- [My Account](https://support.lightwaverf.com/knowledge/app-guidance-automations?hsLang=en#my-account)
- [App Guidance](https://support.lightwaverf.com/knowledge/app-guidance-automations?hsLang=en#app-guidance)
- [Automations](https://support.lightwaverf.com/knowledge/app-guidance-automations?hsLang=en#automations)
- [Troubleshooting](https://support.lightwaverf.com/knowledge/troubleshooting?hsLang=en#main-content)
- [General](https://support.lightwaverf.com/knowledge/troubleshooting?hsLang=en#general)
- [Lighting](https://support.lightwaverf.com/knowledge/troubleshooting?hsLang=en#lighting)
- [Heating](https://support.lightwaverf.com/knowledge/troubleshooting?hsLang=en#heating)
- [Power](https://support.lightwaverf.com/knowledge/troubleshooting?hsLang=en#power)
- [Automations & Hub](https://support.lightwaverf.com/knowledge/troubleshooting?hsLang=en#automations-hub)
- [Installation Guides](https://support.lightwaverf.com/knowledge/installation-guides?hsLang=en#main-content)
- [Link Plus Hub](https://support.lightwaverf.com/knowledge/installation-guides?hsLang=en#link-plus-hub)
- [Lighting](https://support.lightwaverf.com/knowledge/installation-guides?hsLang=en#lighting)
- [Power](https://support.lightwaverf.com/knowledge/installation-guides?hsLang=en#power)
- [Relays](https://support.lightwaverf.com/knowledge/installation-guides?hsLang=en#relays)
- [Connect Series Support Archive](https://support.lightwaverf.com/knowledge/connect-series-support-archive?hsLang=en#main-content)
- [General](https://support.lightwaverf.com/knowledge/connect-series-support-archive?hsLang=en#general)
- [Lighting](https://support.lightwaverf.com/knowledge/connect-series-support-archive?hsLang=en#lighting)
- [Heating](https://support.lightwaverf.com/knowledge/connect-series-support-archive?hsLang=en#heating)
- [Power](https://support.lightwaverf.com/knowledge/connect-series-support-archive?hsLang=en#power)
- [Contact Us](https://support.lightwaverf.com/knowledge/contact-us?hsLang=en#main-content)
- [Product Returns](https://support.lightwaverf.com/knowledge/contact-us?hsLang=en#product-returns)
- [Contact Us](https://support.lightwaverf.com/knowledge/contact-us?hsLang=en#contact-us)
[-1.png?width=58&height=24&name=Lightwave%20Logo%20Green%20Small%20(320%20x%20132)-1.png "Chill listening crop-3")](http://lightwaverf.com)
[mailto:email@email.com](mailto:email@email.com)
Copyright © 2025, Lightwave