Why Xiaomi Humidifier Doesn't Connect to Mi Home on iPhone and How to Fix It
Xiaomiβs humidifiers (Smartmi, Viomi, Mi Air Humidifier) have long become the smart home standard thanks to a combination of price, functionality and integration with the Mi Home ecosystem. The device is not located, the application produces an error "Can not add the device", or the process is suspended during the pairing stage (BLE) iPhone and regional restrictions of Xiaomi servers.
In this article, the instructions for connecting the humidifier to Mi Home on iOS with the Russian version of the application, including bypassing typical errors, are current for 2026.
- πΉ Preparing the device and phone before pairing (including location and Bluetooth settings).
- πΉ Step-by-step process of adding a humidifier through Mi Home, taking into account the features of iOS 17+.
- πΉ Common Errors (codes 10001, 10008, 10012) and their solutions.
- πΉ Alternative ways to connect if the standard method does not work.
All steps are tested on Smartmi Air Humidifier 2/3, Viomi V3 and Mi Air Humidifier CA1 models with firmware from 2023-2026. If your model is older, check the relevance of the firmware in the Software Update section.
Preparation before connection: 5 mandatory steps
Before adding a humidifier to Mi Home, make sure all the preconditions are met, and skipping at least one item causes failures in 80% of cases.
β οΈ Note: If the humidifier has already been connected to another Xiaomi account, reset to factory settings first.
- π± Update Mi Home to the latest version in the App Store.Older versions (below 6.5.400) do not support newer humidifier models.
- π Set the region "Russia" in the settings of the Mi Home account. for this, go to Profile β Settings β Region.
- πΆ Connect your iPhone to 2.4GHz Wi-Fi. Xiaomi Humidifiers don't work with 5GHz! If the router has one network, split it in the settings.
- π Charge the humidifier by at least 50%. At low battery level (if the model is portable), the connection may be interrupted.
- π Enable geolocation for Mi Home in iOS settings: Settings β Confidentiality β Geolocation services β Mi Home β Β«In the case ofΒ».
βοΈ Checking before connection
If your router supports a guest network, temporarily connect to it, this will prevent the device from being blocked by a firewall. Also check that the router's settings have turned off the filter. MAC-Addresses and protocols are on IPv4 (Some humidifiers do not work with IPv6).
Step-by-step: how to add a humidifier to Mi Home on iOS
Follow the algorithm in strict order, and if you have a mistake at some point, don't start over, go to the "Error Discovery" section.
- Activate the pairing mode on the moisturizer: π For Smartmi Air Humidifier 2/3: Hold the power button 5 seconds until the indicator starts flashing orange. π For Viomi. V3/V4: Press and hold the "Mist" button for a period of time. 8 seconds. π For Mi Air Humidifier CA1: press the touch button on 10 seconds until you hear the beep.
- Open Mi Home and press + β Add Device. Select Humidifier (if the model is not listed, use manual add-on).
- Confirm the connection: π΅ On the iPhone will be a request for Bluetooth connection β allow. π΅ Enter a password from your Wi-Fi network (2.4 GHz only!). π΅ Wait for the sound signal from the humidifier (squeaking or double blinking).
Set up the device:
- π Select a room (e.g., "BedroomΒ»).
- π Set target humidity (optimally 40β60%).
- π Enable "Authorize" if it is supported by your model.
π‘
If the humidifier doesn't appear on the list of available devices, try logging out of your Mi Home account and logging in again, sometimes resetting the cache of connections.
The critical detail: if the humidifier is displayed as "Offline" after a successful connection, reboot the router, which solves the problem 90 percent of the time without reconnecting.
Error Discovery: What to Do If the Humidifier Is Not Connected
Errors when connecting Xiaomi humidifiers to iOS fall into three categories: problems with Bluetooth, Wi-Fi and Xiaomi servers. Below is a table with error codes and solutions:
| Error code | Reason. | Decision |
|---|---|---|
| 10001 | The device does not respond (battery discharged or firmware failure) | Charge the humidifier 100% or perform a reset |
| 10008 | Failed to connect to Wi-Fi (incorrect password or 5 GHz network) | Check password, switch to 2.4 GHz, disable VPN |
| 10012 | Xiaomi server is not available (regional restrictions) | Change the region to βRussiaβ or use a manual addition |
| 10020 | The device is already linked to another account | Reset the humidifier to factory settings (see below) |
If the error is not listed in the table, try:
- π Reboot the humidifier (disconnect from the network for 30 seconds).
- π± Remove the Mi Home cache (iPhone settings) β Mi Home β Β«Reset the settingsΒ»).
- π Change. DNS on a router on 8.8.8.8 (Google) or 1.1.1.1 (Cloudflare).
What if the humidifier is connected, but shows incorrect humidity?
Manual addition of a humidifier (if the automatic search does not work)
If your humidifier model doesn't appear on the list of available devices, use manual mode.It works for most devices on an ESP8266 or Realtek RTL8710 chip.
- In Mi Home, click β+β β βAdd Deviceβ β βOtherβ β βSmart Homeβ.
- Select βAdd Manuallyβ and enter MAC-the address of the humidifier (located on the sticker below or in the documentation).
- Specify the model manually (e.g. zhimi.humidifier.ca1 for Mi Air Humidifier CA1). For a full list of model identifiers, see below.
- Confirm the connection and wait for synchronization (can take up to 5 minutes).
If the manual addition didnβt work, try alternative apps:
- π± Mi Home (Chinese version) β sometimes supports more devices, but requires a Chinese account.
- π± Aqara Home is compatible with some Smartmi models.
- π± Home Assistant β for advanced users (requires customization through the YAML).
Resetting the humidifier to factory settings
Reset is required in three cases:
- π The humidifier was tied to another Xiaomi account.
- π The device is unstable (does not respond to commands from Mi Home).
- π You forgot the Wi-Fi password it was connected to.
Resetting instructions:
- Turn off the humidifier.
- Press the power button (or touchpad) and hold for 15-20 seconds until the indicator flashes red and blue quickly.
- Release the button β the device will emit a double beep and restart.
- Connect the humidifier to the network and repeat the pairing procedure with Mi Home.
β οΈ Note: After resetting, all user settings (target humidity, schedule) will be deleted.If the humidifier supports cloud backup, restore data to Mi Home via Profile β Settings β Backup.
Update the firmware moisturizer through Mi Home
Outdated firmware is a common cause of unstable work. Xiaomi regularly releases updates to fix connection errors, especially for iOS.
To update the software:
- Open Mi Home and select your humidifier.
- Go to Device Settings β General β Firmware Update.
- If the update is available, click Update and wait until it is completed (donβt disconnect the humidifier from the network!).
If the update button is inactive:
- π Check your internet connection (humidifier must be online).
- π Make sure that the Mi Home has a Russia region (for other regions, updates may be blocked).
- π Try updating your firmware through an alternative app (e.g. Mi Home China).
π‘
After updating the firmware, the humidifier can automatically disconnect from the Mi Home. In this case, repeat the connection procedure again.
List of supported models and their identifiers for manual addition
If your model is not automatically identified, use these identifiers when manually adding:
| Model | Identifier for Mi Home | Support for iOS |
|---|---|---|
| Smartmi Air Humidifier 2 | zhimi.humidifier.ca1 | Yes (firmware 1.5.0+) |
| Smartmi Air Humidifier 3 | zhimi.humidifier.ca4 | Yes (firmware 2.1.0+) |
| Viomi V3 | viomi.humidifier.v3 | Yes (requires China region) |
| Mi Air Humidifier CA1 | zhimi.humidifier.ca1 | Yes (firmware 1.4.1+) |
| Smartmi Evaporative Humidifier | zhimi.humidifier.cb1 | Partially (mistakes with iOS 17) |
If your model is not on the list, check its compatibility on the official Mi Home website (Supported Devices section).