How to connect the Xiaomi lamp to the application: full instructions with error solutions

Xiaomi smart bulbs are among the most popular smart home devices due to their combination of price, functionality and integration with the Mi Home ecosystem. However, even experienced users sometimes have difficulties with the first connection: the lamp does not find the network, the application does not see the device, or the process ends with a Failed to connect error. In this article, we will analyze all the stages of connection – from preparation to solving non-standard problems – taking into account the latest firmware updates in 2026.

It is important to understand that the connection algorithm may vary depending on the lamp model (Xiaomi Mi). LED Smart Bulb, Yeelight LED, Mi Bedside Lamp and versions of the app (Mi Home, Xiaomi Home or Home Assistant) will be covered by generic steps and device-specific nuances. If you’ve already tried to connect and got an error, skip the basic partitions and go straight to the problem-solving block.

1.Preparation for connection: what to check before starting

Before you start syncing the lamp with the application, make sure that all the prerequisites are met, which will eliminate 80% of the typical errors.

  • 📶 Wi-Fi network: the lamp only connects to the network 2.4 GHz. If your router is running 5 GHz 2.4/5 GHz Auto, create a separate network for the 2.4 GHz or change the router settings.Yeelight and new Mi models LED supportive 5 GHz, but you still need to set up the first setup. 2.4 GHz.
  • 🔋 Power the lamp: screw the lamp into the cartridge and make sure the switch on the wall is on. Many users forget that the smart lamp will not respond to commands if it is physically de-energized.
  • 📱 Appendix: Install the latest version of Mi Home (for the first time) Android/iOS) Xiaomi Home (if you are using a European region) or older versions may not support new connection protocols.
  • 🌍 Account Region: If you bought a lamp in China and your Xiaomi account is registered in Russia, you may have server problems).

Also check that your smartphone is Bluetooth enabled — some lamp models (such as the Mi Bedside Lamp 2) use it for initial setup. IP-the address of the device in the local network - it can be found through the router.

📊 What Xiaomi Smart Lamp Is It You Use?
Xiaomi Mi LED Smart Bulb
Yeelight (any model)
Mi Bedside Lamp
Another model

2. Step-by-step instruction: connection via Mi Home

Consider the standard connection algorithm on the example of Xiaomi Mi LED Smart Bulb Essential.For other models, the steps are similar, but fine details may differ (e.g., the number of blinks when resetting).

  1. Open the Mi Home app and log in. If you don't have an account, sign up (preferably select the region that matches where you bought the lamp).
  2. Wait until the process is complete (usually takes 1-3 minutes), and the lamp should flash green, signaling a successful connection.

If there is an error at any stage, write down the code (for example, -401 or -2001) And then go to the solutions section, and also check that the phone has geolocation permission for the Mi Home app, and without that, the connection can be blocked.

☑️ Checklist before connection

Done: 0 / 5

3. Alternative ways of connecting

If the standard method didn't work, try alternatives. They're also useful if you want to integrate the lamp into other smart home systems.

3.1 Connection through Home Assistant

Home Assistant is a popular smart device management platform, to plug in a Xiaomi lamp:

  1. Install the Xiaomi Miio component via HACS or manually.
  2. Get the Token device using the Miio-cli utility or through the Mi Home Packet Capture app (Android required).
  3. Add the lamp to the configuration file configuration.yaml: light: - platform: xiaomi_miio name: "Xiaomi Lamp" host: 192.168.1.100 # IP-token: YOUR_TOKEN_HERE
  4. Reboot Home Assistant.

3.2 Connection via Google Home or Apple HomeKit

For integration with Google Assistant or HomeKit:

  • 🔗 In Mi Home, go to the lamp settings → «Smart assistants» → select the right service.

Connection without Internet (local mode)

Xiaomi’s lamp can work without Xiaomi’s cloud, but it requires connecting it via Mi Home and then localizing it via Home Assistant or alternative firmware (such as OpenBeken) to help users avoid depending on Xiaomi’s servers.

💡

If the lamp connects, but periodically falls off Wi-Fi, try in the router settings to fix it static IP-This will solve the problem of constant reconnection.

4. Solving common connection errors

Even with proper preparation, errors can occur, and below is a table of the most common problems and ways to fix them.

Error Code/SituationPossible causeDecision
-401 or “I was unable to connect to the device»The lamp is not in pairing mode or too far from the phone.Reset the lamp (5 times to turn on / off) and reconnect at a distance of 10-20 cm.
-2001 or "Incorrect Wi-Fi password»The application cannot connect to the network.Check the password if the network is hidden (SSID It is not broadcast, make it visible temporarily.
The lamp flashes red after trying to connectIncompatibility of Xiaomi server region with lamp modelChange the region in Mi Home to Mainland China or use Home Assistant.
Appendix "does not see" lampConflict with other smart devices or outdated lamp firmware.Turn off other smart devices while you're connected. Update the lamp's firmware through Mi Home.
Connection freezes during the “Save to the Cloud” phaseXiaomi server problems or slow internet.Try again later or connect via mobile internet (4G/5G).

If your error is not in the table, try the following universal steps:

  1. Restart the router and phone.
  2. Remove the lamp from the device list in Mi Home (if there is one) and start over.
  3. Check if the antivirus or firewall blocks network access for the Mi Home app.
What if the lamp is connected but does not respond to commands?
This problem is often associated with conflict. IP-Addresses or malfunctioning of Xiaomi cloud servers. Try: 1. Reboot the lamp (turn off/on power for 10 seconds). 2. In Mi Home, go to the lamp settings → «Firmware update.” 3. If you use Home Assistant, check that the device token has not changed (sometimes Xiaomi resets it after updates).

4.How to Reset Xiaomi Lamp to Factory Settings

Reset is required if the lamp has previously been connected to another account, or if the pairing process has stalled.

4.1 Reset for Xiaomi Mi LED Smart Bulb / Yeelight

  1. Turn the lamp on the network (pin into the cartridge and supply power).
  2. Turn off and turn on the lamp 5 times in a row at intervals of 1-2 seconds. After the fifth switch on, the lamp should start flashing quickly white and yellow.
  3. The lamp is now ready for a new connection.

Reset for Mi Bedside Lamp

The Mi Bedside Lamp has a touchpad.

  1. Hold the switch on for 10 seconds until the lamp starts flashing.
  2. Release the button and wait for the beep (beep).

⚠️ Warning: After reset, the lamp will lose all previous settings (brightness, color profiles, schedules).If the lamp was tied to a Xiaomi account, it must be removed from the list of devices in the Mi Home before reconnecting.

5. setting up the lamp after connection

Once the lamp is successfully connected, you can customize it to your needs.

Brightness and colour control

At the Mi Home appendix:

  • 🎨 Color temperature: slider from warm (2700K) coldly (6500K) light.
  • 🌈 RGB-Mode: available for color-enabled models (e.g. Yeelight Color) and can be selected from the palette or used ready-made scenes (Romantics, Reading, etc.).
  • ☀️ Automatic adjustment: adjust the brightness change depending on the time of day (e.g., warm light in the evening).

Schedules and automation

To turn the lamp on/off in time:

  1. In the lamp settings, select "Schedule» → «Add».
  2. Specify the time, days of the week and action (turn on/off/change color).
  3. For advanced scenarios, use Automation (e.g., If the motion sensor is triggered, turn on the lamp).

Voice control

The lamp can be controlled by voice through:

  • 🗣️ Alice (Yandex): say “Alice, turn on the lamp in the living room” (preliminary link Xiaomi and Yandex accounts).
  • 🤖 Google Assistant: OK Google, set bedroom lamp to 50% brightness».
  • 🍎 Siri: HomeKit Bridge (e.g. Home Assistant with homekit plugin).

💡

For stable voice commands, make sure that the lamp and phone/column are connected to the same Wi-Fi network, otherwise there may be delays of up to 2-3 seconds.

6. Post-connection problems and their solutions

Even if the connection is successful, it can be difficult to operate, and here are the most common ones:

6.1 The lamp is periodically disconnected from Wi-Fi

Causes and solutions:

  • 📶 Weak Wi-Fi signal: Move the router closer to the lamp or use a signal repeater.
  • 🔄 Conflict IP-Addresses: in the router settings, fix the static lamp IP.
  • ⚡ Power problems: If the lamp is connected through a lighted switch, the latter may interfere with the electronics.

6.2. The lamp does not respond to commands from the application

What to do:

  1. Check if the lamp power is on (the switch on the wall).
  2. Reset the lamp (turn off/on power for 10 seconds).
  3. In Mi Home, update the lamp firmware (Update section in the device settings).
  4. If nothing helps, reset and connect again.

The lamp flashes or spontaneously changes color

This may be related to:

  • 🐛 Firmware failure: update the lamp software.
  • 📡 Interference from other devices: disconnect other smart gadgets (outlets, sensors) for a while).
  • ⚡ Unstable voltage: check the cartridge and wiring.

⚠️ Note: If the lamp flashes red after the firmware update, this may indicate a hardware malfunction.In this case, contact Xiaomi support (especially if the device is warranty-based).

7. Compatibility with other smart home systems

Xiaomi lamps can be integrated not only into the Mi Home, but also into other ecosystems.

PlatformRequired.Limitations
Home AssistantXiaomi Miio component, device tokenSome models require manual indication IP-address
Google HomeXiaomi account binding in Google Home settingsNot all models are supported (e.g. Mi Bedside Lamp 2 may not be displayed)
Apple HomeKitHome Home Assistant or Mi Home Bridge with HomekitOnly some Yeelight models work without a bridge.
Alice (Yandex)Linking Xiaomi account in the Yandex applicationVoice commands work with a delay of 1-2 seconds

For enthusiasts who want full control of the lamp, you can flash alternative software like OpenBeken or Tasmota.

  • 🔧 Manage a lamp without a cloud Xiaomi.
  • 📊 Get detailed telemetry (temperature, voltage).
  • 🔄 Integrate the lamp into any system through MQTT.

⚠️ Warning: Third-party firmware will void the warranty and may cause the device to fail.

Frequently asked questions

Can I connect a Xiaomi lamp without the Mi Home app?
Yes, but it will require alternative software, such as Home Assistant or OpenHab. However, to get the Token device initially, you still need to connect to Mi Home (or use special utilities like miio-cli) at least once.
Why does the lamp connect to Wi-Fi, but the app shows offline?
This problem is usually related to blocks from Xiaomi servers or incorrect settings of the region. Try: Change the region in Mi Home to China. Update the lamp firmware. Reconnect the lamp to the network, resetting it beforehand. If nothing helps, check whether your provider is blocking access to Xiaomi servers (relevant for some corporate networks).
How to connect a Xiaomi lamp to multiple phones?
In Mi Home, you can share the device. To do this, open the lamp settings in the app. Select Shared access» → «Add a family member. Enter the second user's email or phone (he must have a Xiaomi account). Note that the second user will only be able to control the lamp, but will not be able to change its settings or delete the device.
Can I use a Xiaomi lamp without the internet?
Yes, but with the caveat: the lamp will work locally, but you need to connect it first via Mi Home, and you can only control it through Home Assistant or other systems that support locally-based lighting. API Xiaomi. Voice assistants (Alice, Google Assistant) will not work, as they require cloud interaction.
What Xiaomi lamps support RGB And what white lights are there?
Here is a short list of popular models: 🎨 RGB + white light: Yeelight Color, Mi LED Smart Bulb (RGB), Yeelight LED Ceiling Light. ☀️ White light only (regulated temperature): Mi LED Smart Bulb Essential, Yeelight White, Mi Bedside Lamp. Before buying, check the model specifications on the official Xiaomi website or in the store.