How to add Xiaomi device to the server: instructions with pictures and tips

Xiaomi’s smart home ecosystem has hundreds of devices, from Yeelight light bulbs to Mi Robot robot vacuum cleaners. But the first thing users encounter is connecting the gadget to the Mi Home or Mijia server. Without the right binding, the device will not appear in the application, will not receive firmware updates and will not be able to interact with other devices in the system.

In this article, we will look at all the ways Xiaomi devices can be added to a server, from standard Bluetooth connectivity to manually entering MAC- addresses for rare models. We will focus on common errors (such as 10012 code or 20004 code) that interfere with synchronization, and explain how to fix them. If you are just starting to build a smart home or encounter a problem when adding a new gadget, here you will find solutions.

Important: the procedure may vary depending on the server region (China, Europe, Russia) and the firmware version of the device. We will look at universal methods that work for most models, including Xiaomi Mi Band, Aqara, Redmi and other sub-brands.

1. Preparation before addition of the device

Before you start connecting, make sure that the basic conditions are met, otherwise you risk getting an error while you are still searching for the device.

  • πŸ“± Install the latest version of the app: Mi Home (for most devices) or Mijia (for Chinese models). Download from official sources, mi.com or app stores.
  • 🌍 Select the correct server region: your current region should be specified in your account settings (Profile β†’ Region); for Russia; for Europe, Europe; if the region does not match the device’s firmware, it will not connect.
  • πŸ”‹ Charge or turn on the device: the robot vacuum cleaner should be on the base, the motion sensor with a fresh battery, and the socket is connected to the 220V network.
  • πŸ“Ά Check Wi-Fi: The device and smartphone must be on the same 2.4GHz network (most Xiaomi gadgets don't support 5GHz). Disable VPN and the proxy.

If you connect an Aqara or Yeelight device, you may need a separate app from the sub-brand, for example, Yeelight light bulbs are better added through the Yeelight App and then synced with the Mi Home.

⚠️ Warning: Some devices (e.g., Xiaomi Mi Air Purifier 3H) require a firmware update before connecting. If the gadget has previously been used with another account, reset to factory settings (usually by pressing a button for 5-10 seconds).

πŸ“Š What type of Xiaomi device are you trying to plug in?
Smart light bulb
Sensor (movements, openings)
Robot vacuum cleaner
Socket or switch
Other gadgets

2. Standard method: Adding via Mi Home

This is the most common method, which works for 90% of Xiaomi devices, and the instructions are relevant for the Mi Home app version 6.0 and later.

  1. Open the app and log in to your Mi Account.
  2. Click on the + (add device) icon in the upper right corner.
  3. Select the category of the device (for example, Lighting β†’ Smart Light bulb).
  4. Follow the instructions on the screen: usually press a button on the device (e.g., 3 times on the switch) or scan the QR- code.
  5. Wait 10 to 30 seconds for the device to connect to the server.

If the device is not located, try:

  • πŸ”„ Reboot the router and smartphone.
  • πŸ“‘ Move closer to the router (some devices, such as the Xiaomi Mi Temperature & Humidity Sensor, have a weak Bluetooth signal).
  • πŸ”Œ Connect the device to another power source (e.g., USB- socket to charge from the phone).

The device is on and ready to pair

Smartphone and device in the same Wi-Fi network 2.4 GHz

The application selects the correct server region

VPNs and ad blockers disabled

The device is not linked to another account-->

3 Manual Addition to MAC- Address

Some devices (especially older or Chinese versions) are not automatically detected, and manually entering MAC- addresses will help.

MAC- address is usually given:

  • 🏷️ On a sticker on the device body (e.g., under the sensor cover or at the bottom of the robot vacuum cleaner).
  • πŸ“„ In the instructions for use (Section Technical Specifications).
  • πŸ” In a mobile application (if the device has already been connected).

How to add it manually:

  1. In Mi Home, click + β†’ Add manually.
  2. Select the category and model of the device (if it is not in the list, select the nearest functionality).
  3. Enter MAC- address in XX:XX:XX:XX:XX:XX format (without spaces and dash).
  4. Confirm the addition and wait for synchronization with the server.
The deviceWhere to find MAC-addressExample of format
Xiaomi Mi Robot VacuumAt the bottom of the case, under the battery cover.78:11:DC:12:AB:45
Aqara Door & Window SensorOn the back of the sensor.50:EC:50:98:7C:3E
Yeelight LED Ceiling LightOn the Yeelight mobile app34:CE:00:6F:8D:1A
Xiaomi Mi Smart SocketOn the side stickerA4:C1:38:F0:2B:E9

⚠️ Warning: If the device is displayed as Offline after manual addition, check if it supports your server region. For example, the Chinese versions of Mi Air Purifier do not work with a European server without Custom Firmware firmware.

Connection via Bluetooth (for devices without Wi-Fi)

Temperature sensors, Aqara buttons and some other devices connect via Bluetooth Low Energy (BLE), a process different from Wi-Fi connections:

  1. Turn on Bluetooth on your smartphone.
  2. In Mi Home, select Add Device β†’ via Bluetooth.
  3. Activate the pairing mode on the device (for example, press the button on the Xiaomi Mi Flora sensor for 5 seconds).
  4. Wait for the app to find the device and confirm the connection.

Features of Bluetooth devices:

  • πŸ“Ά Only work within a 10-15-meter radius of a smartphone or hub (e.g., Xiaomi Mi Smart Home Hub).
  • πŸ”„ Data is updated less frequently than Wi-Fi devices (e.g., temperature every 2-5 minutes).
  • πŸ”‹ Consume less energy but require periodic battery replacement.

πŸ’‘

If the Xiaomi Mi Temperature & Humidity Sensor doesn't connect, try removing and inserting the battery back in. Sometimes this resets the Bluetooth module errors.

5. Solving common mistakes

When adding devices, users often encounter error codes, and here are the most common ways to fix them:

Error codeReason.Decision
10012The device is not responding.Restart the device and router, check the power
20004The wrong server regionChange region in your account settings to China (for Chinese devices)
10008The device is linked to another accountPerform reset to factory settings
10030Weak Wi-Fi signalBring the device closer to the router or use a repeater

If the error does not disappear, try:

  • πŸ“± Delete the cache of the Mi Home app (Phone Settings β†’ Apps β†’ Mi Home β†’ Memory β†’ Clear the cache).
  • πŸ”„ Switch Wi-Fi from 5 GHz to 2.4 GHz (even if the router supports both bands).
  • 🌐 Use another DNS (e.g., Google 8.8.8.8) in the router settings.
What if the device is connected but shows Offline?
1. Check if the indicator on the device is on (for example, blue LED on the Mi Smart Socket). 2. Make sure that the router settings turn off AP Isolation. 3. Try reconnecting the device to another Wi-Fi network (for example, via a mobile hotspot). 4. If nothing helps, reset the device and repeat the add-on procedure.

6. Additional settings after connection

After successfully adding the device to the Xiaomi server, it is recommended that:

  • 🏠 Assign a room: In the Mi Home app, drag the device to the desired room (like the Living Room or the Bedroom) and make it easier to control it through voice assistants (Alice, Google Assistant).
  • πŸ”„ Update your firmware: Go to your device settings and check for updates, which will fix bugs and add new features.
  • πŸ” Set up Sharing: If you want your device to be managed by other family members, add their accounts to Settings β†’ Sharing.
  • βš™οΈ Activate automation: Create scenarios in the Automation section (e.g., if the motion sensor is triggered β†’ turn on the lights).

Some devices (e.g. Xiaomi Mi Air Purifier) have advanced customizations available through Custom Firmware, which add support for other regions, new modes of operation and integration with Home Assistant, but require experience and may be unwarranted.

πŸ’‘

If the device is connected but not listed, check the filters in the app, for example, Mi Home may be hiding devices from other regions by default.

7. Features of connecting Aqara and Yeelight devices

The devices of the Aqara and Yeelight sub-brands often require a separate approach.

Aqara (sensors, switches, hubs)

Aqara requires a hub (like the Aqara Hub or Xiaomi Mi Smart Home Hub) without which most sensors won't be transmitting data to the server.

  1. Add a hub to Mi Home via Wi-Fi.
  2. Activate the pairing mode on the hub (press the button for 3 seconds).
  3. Add the sensor via Bluetooth (as described in Section 4).

Yeelight (light bulbs, LED panels)

Yeelight light bulbs are better to add through the company app, and then synchronize with Mi Home:

  1. Install the Yeelight App and create an account.
  2. Add the light bulb via Wi-Fi (press the button on the base 5 times).
  3. In Mi Home, select Add Device β†’ Yeelight and log in through the same account.

⚠️ Warning: Yeelight light bulbs do not support Aqara hub operation. They are required to have a direct Wi-Fi connection.

FAQ: Frequent questions about connecting Xiaomi devices

Can I connect the Chinese version of the device to a European server?
Yes, but you need to: Change your account region to China in Mi Home settings. Use Chinese firmware (sometimes you need manual firmware through Mi Home Custom Firmware). Note that some features may not work well (for example, voice control in Russian). Alternatively, buy a global version of the device (labeled Global or EU).
Why does the device connect, but shut down every other day?
Reasons: The router locks the device (check MAC- filtering in settings); weak Wi-Fi signal (try repeater); energy-saving mode on the device (turn off in settings if there is such an option); Xiaomi server is temporarily unavailable (check status on status.mi.com).
How to transfer your device to another account?
To transfer the device to another user: In Mi Home, go to device settings. Select Sharing β†’ Transfer possession. Enter the new owner's email (he must have a Mi Account). The new owner must confirm the transfer in his app. If the option is not available, reset the device and add it again to the new account.
Can I connect a Xiaomi device without the internet?
Yes, but with limitations: Devices will only work on the local network (for example, the light bulb will turn on on the timer, but will not receive an update); Voice control (Alice, Google Assistant) and remote access via the Internet will not work. Internet is mandatory for initial connection (you need to log in to the Xiaomi server).
What if my model of the device is not on the list?
Possible solutions: Check that you have chosen the right category (e.g., robot vacuum cleaner may be hiding in the Cleanup section). Update the Mi Home app to the latest version. Try adding the device manually to the MAC- address (3 section). If the device is new, wait for the 1-ZXXPH0003QXZ week - perhaps support has not yet been added to the server.