Connecting the Xiaomi Yeelight lamp to the app: a full guide with pictures and tips

Xiaomi Yeelight smart bulbs have long become the standard for lighting in smart home systems, allowing you to control brightness, color, and even create automation scenarios through your smartphone. But before you can enjoy all of these features, you need to connect the device to the app correctly, and this is where many users have a hard time, especially if you're talking about the first models of the series (for example, Yeelight). LED Color or Yeelight Moonlight Bedside Lamp, which require specific settings.

In this article, we will explore all possible ways to connect – through the official Mi Home app, the proprietary Yeelight App, as well as alternative methods for advanced users. You will learn how to avoid typical errors (such as endless search for a device or login failures), which communication protocols are used (Wi-Fi, Bluetooth Mesh, Zigbee), and what to do if the lamp refuses to connect.

If you've just unpacked a new lamp or are trying to reconnect an old one after you reset, this will save you time and nerves. And for those of you who like experimentation, we've added a section on manual control through the use of a new light. API Integration with Home Assistant.

1.Preparation for connection: what to check before starting

Before you start setting up, make sure that all conditions are met, which will save 90% of the problems during the pairing phase.

First, check the compatibility of the lamp and the application. Not all Yeelight models work with the Mi Home, and some (for example, the Yeelight Pro) require the mandatory use of the proprietary Yeelight App. The full list of supported devices can be found on the official website in the Support section. → Compatibility.

Second, look at the lamp firmware version: Outdated firmware (especially on 2018-2020 models) may not support modern authorization protocols. If the lamp has been used before, reset to factory settings (instructions below).

Finally, prepare a Wi-Fi network:

• 📶 2.4GHz Yeelight lamps (except for new Wi-Fi 6 models) don’t work at 5GHz. If your router supports both bands, temporarily disable 5GHz or create a separate network for 2.4GHz.
• 🔒 No special characters in your password. Use only Latin letters and numbers #, $ Cyrillic can cause a connection error.
• 🌐 Absence VPN/Mi Home and Yeelight Apps require direct access to Xiaomi servers in China. VPN before setting up.
• 📱 App permissions. On Android, give Location, Wi-Fi and Bluetooth. On iOS, check LAN permissions.

⚠️ Note: If you use a corporate or hotel Wi-Fi network with browser authorization (captive portal), connecting the lamp will not be possible.

2. Method 1: Connect via the Mi Home app

Mi Home is a one-stop app for all Xiaomi ecosystem devices, including Yeelight lamps, which is suitable for most models but has nuances with regional servers.

Step 1: Installation and authorization

Download Mi Home from Google Play or App Store. When registering, select Russia (or Mainland China if you plan to use Chinese servers for advanced features). Yeelight lamps purchased in Russia may not appear when selecting other regions (e.g. Europa).

Step 2: Adding a device

1.Push. + → Add the device in the upper right corner.

2. Select the Lighting category, then find your lamp model.

3. Follow the instructions on the screen: turn the lamp into the socket and wait for the blinking (usually 3 times in a row).

4. Confirm the blinking in the app and select your Wi-Fi network.

Step 3: Account binding

Once the light is successfully connected, it will appear on the device list.

• 🔄 Reset the lamp (turn off/on power for 10 seconds).
• 📱 Reinstall the Mi Home app (sometimes changing the region to China and back helps).
• 🌍 Check if firewall or antivirus is blocking access to Xiaomi servers.

The lamp is turned on in the socket and flashes 3 times|

Selected Wi-Fi 2.4 GHz network without special characters in the password|

Mi Home app is authorized in Russia region|

On the smartphone included Bluetooth and geolocation|

The lamp was not previously linked to another account.-->

Challenges and solutions

If the lamp is connected but does not respond to commands:

- Check if it's added to the blacklist in the router's settings.

- Update the lamp firmware through the device settings → Update to Mi Home.

Try reconnecting the lamp to another account (for example, a temporary one).

⚠️ Note: Yeelight lamps connected via Mi Home may lose communication when you change routers, which requires re-pairing, even if the Wi-Fi network remains the same (changed). MAC-router).

3. Method 2: Connecting through the proprietary Yeelight application

Yeelight offers more lighting controls (e.g. Music Mode, Flow for smooth color transitions), but not all models are supported.

Step 1: Download and register

Install Yeelight from official stores:

- Android

- iOS

Registration is not required – you can use without an account, but then the lamp will be available only on the local network.

Step 2: Connection process

1. Turn the lamp on the network and wait for the blinking (for new devices - fast blinking, for previously used - slow).

2. In the app, click + → Add the device.

3. Select the lamp model from the list (if not, try Another Yeelight device).

4 Enter the Wi-Fi password and wait until the process is complete (usually takes 20–40 seconds).

Differences from Mi Home

Advice for experienced users

If the lamp is connected via Yeelight App but does not appear in Mi Home, you can export it to Mi Home via Device Settings. → Export to Mi Home, which allows you to manage it from both apps.

💡

If the lamp connects, but constantly falls off, try in the router settings to fix it static IP-This will prevent conflicts. DHCP.

4. Connection without applications: manual mode and API

To automate or integrate with systems like Home Assistant, you can plug a lamp in without any formal application, which requires knowledge of network protocols, but gives you complete control of the device.

Method 1: Through the Protocol LAN (locale)

Yeelight lamps support management LAN through UDP/TCP. To activate this mode:

1. Connect the lamp to the Mi Home or Yeelight App at least once.

2. Include. LAN Control in the device settings (Yeelight App: Device Settings) → Developer Mode → Enable LAN Control).

3. use commands via Telnet or HTTP API. Example of a command to turn on a lamp:

echo -n "{\"id\":1,\"method\":\"set_power\",\"params\":[\"on\", \"smooth\", 500]}" | nc -w1 -u 192.168.1.100 55443

where 192.168.1.100 — IP-lamp-head.

Method 2: Through Home Assistant

1. Install the Yeelight component in Home Assistant via Configuration.yaml:

light:


- platform: yeelight




devices:




192.168.1.100:




name: "Yeelight Living Room"

2. Reboot Home Assistant. The lamp will appear in the interface.

Method 3: Through Google. Home/Alexa

The lamp must be linked to your Yeelight or Mi Home account:

1.In Google Home, click + → Set up the device → There are devices already?.

2. Select Xiaomi or Yeelight and log in.

3. the lamp will appear in the list of devices for voice control.

⚠️ Attention: When in use LAN Control lamp becomes vulnerable to local attacks. Always update your firmware and use a strong password for your Wi-Fi network.

5. Typical errors and their solutions

Even if you follow the instructions correctly, Yeelight lamps sometimes refuse to connect, and here are the most common problems and ways to fix them:

Error 1: Lamp not found in app

• 🔌 Power problem. Try another power supply or socket. Some models are sensitive to power surges.
• 📡 Weak Wi-Fi signal. Bring the lamp closer to the router (at a distance of 1-2 meters) during the connection time.
• 🔄 Conflict with other devices. Disable other smart gadgets (e.g. Xiaomi Gateway or cameras) for setup time).

Error 2: The lamp connects but does not respond to commands

• 🌐 Xiaomi Cloud Problems. Check the status of servers at status.mi.com.
• 🔒 Blocking the router. Add the lamp to the DMZ or turn off the firewall.
• 📱 Cache the app. Clear the Mi cache. Home/Yeelight App in the settings of the smartphone.

Mistake 3: Constantly switching off the lamp

• ⚡ Power saving router mode. Turn off the Wi-Fi Power Save option in router settings.
• 🔄 Conflict IP-Give the lamp a static address. IP customized DHCP.
• 📡 Network congestion: If you have more than 20 devices connected to your router, try to reduce the number of devices.

Mistake 4: The lamp flashes but does not connect

This is typical for devices that were previously linked to another account.

1. Turn off / turn on the lamp 5 times in a row (with an interval of 1 second).

2. wait for a long blink (about 10 seconds).

3. Repeat the connection process again.

💡

If you bought the lamp from hand, make sure to reset to the factory settings, the previous owner could have linked it to his account, and without reset, the new connection will not be possible.

6. Integration with other platforms (Google Home, HomeKit, Alice)

Yeelight lamps support integration with popular smart home ecosystems, but this requires pre-tuning.

Google Home / Google Assistant

1. Make sure the lamp is connected to the Mi Home or Yeelight App.

2.In Google Home, click + → Set up the device → There are devices already?.

3. Select Xiaomi (for Mi Home) or Yeelight and log in.

4. The lamp will appear in the list of devices, and now it can be controlled by voice:

Google, turn on Yeelight 50%

Apple HomeKit (for compatible models only)

Not all Yeelight lamps support HomeKit. Check compatibility on the manufacturer's website.

1. Update the lamp firmware to the latest version.

2.In Yeelight App go to Device Settings → HomeKit Setup.

3. Scan it. QR-code through the Apple Home app.

Yandex Alice

1. Connect the lamp to the Mi Home.

2.In the Yandex app go to Devices → Add the device → Xiaomi.

3. log in with the same account as you do on Mi Home.

4. You can now control the lamp with your voice:

Alice, turn the lights in the living room blue.

💡

For smoother work with Alice, rename the lamp to Mi Home in Russian (for example, “Lampa living room”) – this will simplify voice control.

7. Update firmware and reset settings

Regular firmware updates fix bugs, add new features (like HomeKit support for older models) and improve stability. Here's how to do it right.

Update via Mi Home

1. Open the app and select your lamp.

2. Go to Settings (⚙) → Update of the PO.

3. If a new version is available, click Update and wait until it is completed (don't turn off the lamp!).

Update via Yeelight App

1. In the main menu, select a lamp.

2.Push … → Firmware Update.

3. If the update does not appear, check the account region (sometimes new firmware is released for China first).

Manual reset to factory settings

If the lamp is glitching or not connected, perform a full reset:

For models with a button:

Hold the power button for 5-10 seconds until the lamp blinks quickly.

2.For models without a button (e.g. Yeelight Ceiling):

Turn off / turn on the power 5 times in a row at an interval of 1 second.

For all models, through the annex:

- In Mi Home or Yeelight App, go to Device Settings → Remove the device.

⚠️ Warning: After reset, the lamp will lose all settings (including account binding) if it was part of an automation scenario (e.g., in Home Assistant), you will have to reconfigure it.

What to do if the update is suspended?

If the lamp has stopped responding during the update:

1. Wait 15-20 minutes – sometimes the process takes longer.

2 If the lamp does not blink, turn it off for 30 seconds, then turn it on again.

3. If the lamp does not turn on, try to sew it manually through UART (Requires a soldering iron and knowledge of electronics).

8. Frequently Asked Questions (FAQ)