Connecting Xiaomi humidifier to Mi Home on iOS: a complete guide with the Russian interface

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.

πŸ“Š What kind of Xiaomi humidifier do you have?
Smartmi Air Humidifier 2/3
Viomi V3/V4
Mi Air Humidifier CA1
Another model
I haven't bought it yet.

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

Done: 0 / 5

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.

  1. 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.
  2. Open Mi Home and press + β†’ Add Device. Select Humidifier (if the model is not listed, use manual add-on).
  3. 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 codeReason.Decision
10001The device does not respond (battery discharged or firmware failure)Charge the humidifier 100% or perform a reset
10008Failed to connect to Wi-Fi (incorrect password or 5 GHz network)Check password, switch to 2.4 GHz, disable VPN
10012Xiaomi server is not available (regional restrictions)Change the region to β€œRussia” or use a manual addition
10020The device is already linked to another accountReset 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?
This is a typical sensor problem in budget models (e.g. Smartmi Air Humidifier 2). Solutions: 1. Move the device away from walls and furniture (at least 50 cm). 2.Kalibrate the sensor manually: in Mi Home, select the device β†’ Settings β†’ Sensor Calibration. 3. If the error persists, update the firmware (section below).

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.

  1. In Mi Home, click β€œ+” β†’ β€œAdd Device” β†’ β€œOther” β†’ β€œSmart Home”.
  2. Select β€œAdd Manually” and enter MAC-the address of the humidifier (located on the sticker below or in the documentation).
  3. Specify the model manually (e.g. zhimi.humidifier.ca1 for Mi Air Humidifier CA1). For a full list of model identifiers, see below.
  4. 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:

  1. Turn off the humidifier.
  2. Press the power button (or touchpad) and hold for 15-20 seconds until the indicator flashes red and blue quickly.
  3. Release the button – the device will emit a double beep and restart.
  4. 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:

  1. Open Mi Home and select your humidifier.
  2. Go to Device Settings β†’ General β†’ Firmware Update.
  3. 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:

ModelIdentifier for Mi HomeSupport for iOS
Smartmi Air Humidifier 2zhimi.humidifier.ca1Yes (firmware 1.5.0+)
Smartmi Air Humidifier 3zhimi.humidifier.ca4Yes (firmware 2.1.0+)
Viomi V3viomi.humidifier.v3Yes (requires China region)
Mi Air Humidifier CA1zhimi.humidifier.ca1Yes (firmware 1.4.1+)
Smartmi Evaporative Humidifierzhimi.humidifier.cb1Partially (mistakes with iOS 17)

If your model is not on the list, check its compatibility on the official Mi Home website (Supported Devices section).

FAQ: Frequent questions about connecting Xiaomi humidifier to iOS

πŸ”Ή Why does the humidifier connect, but after an hour it turns off?
This is a typical problem when using a guest Wi-Fi network or if the router blocks devices by timeout. Solutions: Turn off the Customer Isolation function in the router settings. MAC-Utilizer address in the "White List" of devices, check if Wi-Fi on the iPhone is turned off in power saving mode (Settings) β†’ Wi-Fi β†’ Low energy regime).
πŸ”Ή Can I connect the humidifier to HomeKit (Apple Home)?
Officially, no, as Xiaomi does not certify its devices for HomeKit. However, there are workarounds: Use Home Assistant with the Mi Home Integration plugin. Set up Shortcuts on your iPhone to manage via the Mi Home API (requires technical skills). Ready-made solutions (such as HomeBridge) may violate Xiaomi's policies, so use them at your own risk.
πŸ”Ή The humidifier is plugged in, but it doesn't respond to commands from Mi Home?
Causes and Solutions: Cloud Latency: Commands can run with lag up to 5 seconds. Check Internet speed. Offline mode: Make sure the humidifier is connected to the same network as the iPhone. Firmware failure: Update the device software (Update the firmware section) Block the router: Open the TCP ports 80, 443, 8080 for the device in the router settings.
πŸ”Ή How to transfer the humidifier to another Mi Home account?
To transfer the device to another user: In Mi Home, select a humidifier β†’ Settings β†’ Sharing. Enter the new owner’s Xiaomi account email. The new user must confirm the invitation in his Mi Home. If the device is not transferred (Error 10020), reset and reconnect.
πŸ”Ή What router settings can block the connection?
Check and disable the following functions: Filtering MAC-Address protection. ARP-spam. IPv6 (Use only IPv4). Firewall for local area network. Qos (Traffic Prioritization) - can limit bandwidth for IoT devices. For stable operation of the humidifier, it is recommended to allocate it a static one. IP customized DHCP router.