Headwind MDM Q&A - Recent questions and answers

Answered: How to install Headwind MDM on a device without a camera by using adb?

Thu, 16 Apr 2026 09:34:45 +0000

Here's the setup flow including adb. We presume adb is already activated (here is how to turn on developer mode and connect the device to the host by adb).

1. Open the list of configurations in the Headwind MDM web panel, choose the configuration for your devices, click the QR code icon, choose the device number assignment strategy (IMEI or serial number), then click "Generate JSON".

2. Save the JSON as init.json on your computer.

3. Download the APK file of the MDM agent to your computer (hmdm-x.xx-os.apk)

4. Connect the device to the computer by usb

5. Run the commands (they could be merged into a script):

adb install hmdm-x.xx-os.apk
adb shell dpm set-device-owner com.hmdm.launcher/.AdminReceiver
adb push init.json /storage/emulated/0/Android/data/com.hmdm.launcher/files/init.json
adb shell am start com.hmdm.launcher

6. To complete the setup, grant the permissions requested by the Headwind MDM launcher.

Answered: mqtt disconnect/reconnect problem

Wed, 15 Apr 2026 09:32:56 +0000

If MQTT protocol does not work well on your devices (most probably due to network issues), consider switching from MQTT to HTTP long polling. This will make Push notifications working more reliably.

Answered: Headwind MDM Launcher - Internal Server Error

Mon, 13 Apr 2026 09:49:54 +0000

When you're getting an Internal Server Error, check the Tomcat log (/var/lib/tomcat9/logs/catalina.out) for the exact error reason, in most cases the log will contain the error reason and the stack trace.

Answered: MDM settings restrictions

Fri, 10 Apr 2026 15:33:22 +0000

To add an activity, please read the instructions: https://qa.h-mdm.com/18181/how-to-open-access-to-settings-sheets

You can find documentation on restrictions here: https://developer.android.com/reference/android/os/UserManager

For example, to disable airplane mode, add the value no_airplane_mode

Answered: Static DNS content control in the browser

Tue, 07 Apr 2026 19:33:56 +0000

This feature is not available on Android.

Perhaps the URL filtering plugin functionality would be more suitable for you:

https://qa.h-mdm.com/17026/can-i-let-user-open-only-some-urls-url-filtering-feature

INSTALL_PARSE_FAILED_NOT_APK error when installing app.

Mon, 06 Apr 2026 15:13:06 +0000

I just finished another test with the Shopee app and saw the logs below.

06/04/2026 11:05:37.902 celular 1 com.hmdm.launcher VERBOSE Update flow completed
06/04/2026 11:05:37.317 celular 1 com.hmdm.launcher ERROR Install failed: INVALID, extra: INSTALL_PARSE_FAILED_NOT_APK: Failed to parse /data/app/vmdl1933863625.tmp/COSU
06/04/2026 11:05:36.979 celular 1 com.hmdm.launcher INFO Silently installing app com.shopee.br 1
06/04/2026 11:05:33.156 celular 1 com.hmdm.launcher DEBUG Downloading app: com.shopee.br

Do you know what it could be?

Answered: Push long polling inquiry

Mon, 06 Apr 2026 15:10:34 +0000

You can use the HTTP polling mode instead of the MQTT mode.

Please check out the article: https://qa.h-mdm.com/5308/there-configure-automatic-polling-configuration-changes

Answered: MDM Agent not launching after a phone restart

Fri, 27 Mar 2026 09:04:00 +0000

Please ensure the MDM launcher is running in MDM mode.

More details here: https://h-mdm.com/compatibility/

re-registration device acount

Fri, 20 Mar 2026 17:59:31 +0000

"The <Parameter name="prevent.duplicate.enrollment" value="1"/> setting allows an account to be enrolled only once. If a device is replaced or damaged, a new device needs to be enrolled. Can you add a re-registration option or button on the web dashboard so the admin doesn’t need to manually recreate the user device account?"

Answered: Remote Exit to System Launcher / Device Unlock on Android 15

Thu, 19 Mar 2026 08:31:01 +0000

There are two available options to unlock the device:

1. Send a push message to the device with the “permissiveMode” option. This temporarily disables restrictions for 3 minutes. Please note that this option does not work in kiosk mode. You can send it to a specific device.

2. Enable the “Permissive (unlocked) mode” option in the configuration settings.

You can create a copy of your configuration with the “Permissive (unlocked) mode” option enabled and apply it to a specific device. Please note that this option also does not work in kiosk mode.

For devices operating in kiosk mode, you can temporarily switch them to a configuration where the “Permissive (unlocked) mode” option is enabled.

We are sorry that Headwind Remote didn't meet your expectations. Our users complained big delays in the screencast delivery. If that's your case, let me note that we have recently released a new version where this issue is reliably resolved - the screencast delay never exceeds a few seconds. Please contact the technical support to get a free trial.

Answered: failed to download the package headwind MDM pager plugin error on android device

Wed, 18 Mar 2026 08:29:17 +0000

It appears that the application details include a link to an APK file hosted on our server.

Please download the application to your computer using a web browser, and then add it to the control panel by following the instructions in the guide:

https://h-mdm.com/quick-start/

Deploying your application section.

Answered: Problème upload app

Fri, 13 Mar 2026 15:01:07 +0000

Try checking your browser console for HTTP errors when trying to upload a file.

You might find a 413 error there: https://qa.h-mdm.com/11659/failed-to-upload-the-app-413-request-entity-too-large

If this isn't the case, check this file: /var/lib/tomcat9/logs/catalina.out; it should contain the error stack trace for the error.

Answered: Is the current Headwind MDM compatible with Android 7.1

Fri, 13 Mar 2026 08:49:03 +0000

Headwind MDM is compatible with most Android devices running Android 7 or higher.

If your device doesn't have a camera, you can install the MDM launcher as a regular app and grant device owner permissions by following these instructions: https://qa.h-mdm.com/1411/how-to-enroll-headwind-mdm-device-owner-android-through-adb

Answered: HMDM docker compose setup with traefik container - reverse proxy setup

Tue, 10 Mar 2026 10:12:07 +0000

To fix the URL entries in the QR code, check these two points:

1. Correct the value of base.url in the Tomcat config file (/volumes/hmdm-config/ROOT.xml), it should be https://mdm.example.com. Restart the container to apply changes.

2. Correct the URL of Headwind MDM launcher in the "Applications" section of the web panel, it should be https://mdm.example.com/files/hmdm-xxxx.apk

Answered: Reconnection loop detected! You have multiple devices with ID=MS-M! MQTT service stopped.

Tue, 03 Mar 2026 10:24:29 +0000

This is usually happening when two devices have the same ID, most probably they were enrolled with the same QR code.

Find the device with the duplicate ID, and re-enroll with another ID (you can also change the device ID in the Headwind MDM agent admin panel, tap and hold the key icon).

Answered: How to install Headwind MDM mobile app without QR code scanning?

Tue, 24 Feb 2026 07:15:45 +0000

If you just install the APK normally, it won’t run as device owner, so things like silent app installs won’t work.

Answered: No Standby - Display always on

Mon, 23 Feb 2026 13:51:36 +0000

This could happen if you set the "Screen always on" checkbox in kiosk mode (configuration details, MDM settings).

Answered: Giving Permission Searching Nearby Devices

Wed, 18 Feb 2026 18:03:37 +0000

Here is a possible workaround.

1. Open the configuration details in Headwind MDM web console, and make sure "Permissions for other apps" is set as "Auto-grant all permissions". Adjust the setting and save the configuration if required.

2. Uninstall the app on the device, and refresh the Headwind MDM configuration on the device. Make sure the application was installed by Headwind MDM.

If you're experiencing this issue on Samsung Knox devices, logcat may help you find a solution.

Uninstall the app, then turn on logcat collecting, and install the app back via Headwind MDM. Make sure logcat contains records tagged by HeadwindMDM. (there should be records like "Permission ... granted to package your.app.package").

Answered: Contacts not syncing with Samsung Contacts app

Wed, 18 Feb 2026 16:22:02 +0000

Please don't set the contact sync interval too short, as this may cause your phone to malfunction. This is likely the issue.

Please set this interval to a much longer value, such as 900 (= 15 minutes), and restart your device.

Another issue may be that the system Contacts app is hiding contacts with a certain "Account Type" value. Try searching for them somewhere in the settings (this is a device-specific option, so I can't provide more details).

Answered: Is it possible to grant "Display over other apps" permissions to our Kiosk application via push messages?

Tue, 17 Feb 2026 07:57:49 +0000

Headwind MDM cannot grant the “Display over other apps” permission via push messages. In Android, this permission can only be granted manually by the user.

When Headwind Remote is launched for the first time, it prompts the user to grant the “Display over other apps” and Accessibility permissions. These permissions must be enabled manually on the device.

Answered: Varying time to action updates/reboot/factory reset

Mon, 16 Feb 2026 13:42:15 +0000

The varying timeframes for updates, reboots, or factory resets can be due to issues with push message delivery. To action commands immediately, ensure MQTT traffic passes correctly and MDM mode is enabled:

https://qa.h-mdm.com/5102/devices-updated-diagnose-push-notification-service-issue

As an alternative solution, you can use the HTTP Long polling method (you can switch it in the configuration details). It doesn't require port 31000 to be open.

Answered: Cant Install HMDM in Lenovo Tablet TB311FU - Settings Wizard has stopped

Wed, 11 Feb 2026 14:32:15 +0000

I got the mdm agnet installed but with a caveat, i first setup the tablet, as is, then i upload the mdm agent apk via cable from a laptop and then i can scan the qr code of the configuration, unfortunately, the web panel doesnt show any serial number so i have to manually give it the id of the tablet to be imported.

Answered: Problème QR Code

Wed, 11 Feb 2026 08:08:02 +0000

The QR code option may disappear if MDM settings are corrupted. Check in the configuration details under "MDM settings" that "Headwind MDM Launcher" is set as the main app and the component is com.hmdm.launcher.AdminReceiver.

More info: https://qa.h-mdm.com/1298/

Answered: adb command?

Tue, 10 Feb 2026 06:51:16 +0000

Headwind MDM doesn't have full adb permissions, it has the device owner permissions.

So you need to test whether the script is working well (use logcat to check).

Answered: what do the table user role settings do

Fri, 06 Feb 2026 13:11:54 +0000

You can adjust permissions available for each user role, and add new user roles, in Settings - User Role Settings.

I believe the description of each permission is self-explanatory. If you still need help with understanding what is the purpose of a certain permission, please contact the technical support.

Answered: How to allow WiFi settings in Kiosk Mode

Tue, 03 Feb 2026 14:06:29 +0000

WiFi settings may be locked because they are in com.android.settings package which is disabled by Headwind MDM by default.

Se how to enable a package here: https://qa.h-mdm.com/1175/getting-application-not-allowed-message-how-allow-running

Note; since kiosk mode doesn't have an option to enter settings from the expanded status bar, enabling com.android.settings in kiosk mode seems to be safe.

Answered: Bluetooth interactions not work

Thu, 29 Jan 2026 07:54:36 +0000

There is a known issue with Bluetooth connectivity on a few device models managed by MDM.

Here's a possible workaround:

1. In Headwind MDM, open the configuration details, MDM settings, and make sure there's no restrictions related to Bluetooth.

2. Turn off kiosk mode if it is on. If the Bluetooth will work and require user interaction, you may need to enable com.android.settings or another related package.

3. Check out logcat for Bluetooth-related errors.

Answered: Headwinds reinstall failing

Wed, 28 Jan 2026 08:00:48 +0000

The configuration is set to use mobile data for the internet connection, which means the device is expected to use a SIM card for connectivity.

Please try unchecking this option and saving the changes (Configuration details -> MDM settings tab).
Then refresh the QR code page and attempt the enrollment again.

Answered: Disable WiFi Hotspot/Tethering configuration

Thu, 22 Jan 2026 14:41:38 +0000

Please make sure the launcher is installed in MDM mode. More details:

https://h-mdm.com/compatibility/

Answered: Issue with Push Message deleteDir: Directory is not being deleted

Thu, 22 Jan 2026 13:50:32 +0000

The syntax is correct. Please try using the path: /Documents/MyDir

To monitor the results, you can enable launcher log collection:

https://qa.h-mdm.com/1573/how-to-turn-on-the-launcher-logs

Answered: APK Upload Error (Content Too Large)

Wed, 21 Jan 2026 15:41:37 +0000

It was a server related issue. Solved

Answered: How we can active the power button on kiosk mode ?

Wed, 21 Jan 2026 15:03:08 +0000

The "Lock the Power button" option prevents only against a long pressing of the power button and turning off the device. It is not possible to intercept and block the power button press and locking the screen.

Answered: Lock, restart, and restore factory settings on devices.

Wed, 21 Jan 2026 07:41:51 +0000

1. First Check are you able to send Messages to the Device.

2. Check the Push Notification setting in the Configuration ->Custom Setting. It should be MQTT protocol

Answered: How we can adjust the logo on devices?

Tue, 20 Jan 2026 12:38:16 +0000

If by logo you mean the background of Headwind MDM launcher, it is resized proportionally to fit the screen. So let me recommend using a square background with a logo in the middle.

Answered: Clear application cache of selected applications

Fri, 16 Jan 2026 15:57:07 +0000

This can only be done manually on the device.

To enable this feature, go to the Applications tab in the configuration settings.

Click the menu button (...) next to the app and check the "Long tap opens settings" box in the window that appears.

Save and close the configuration settings.

Now, long-tapping the app icon will open a menu where you can clear the cache.

Answered: Allowed application does not work in Kiosk Mode when configuration is running before installation

Wed, 14 Jan 2026 08:05:28 +0000

The message "Attempted Lock Task Mode violation" means that the OS blocks the package and you need to unblock it explicitly (more details about the issue here).

You need to enable com.netflix.mediaclient package in your configuration as described here.

Web page kiosk mode not working

Wed, 14 Jan 2026 07:06:54 +0000

Hello,

I’m having an issue running a web page in kiosk mode. I’ve read other related questions and tried using the Kiosk Browser.apk, but it only shows a black screen and nothing loads. I have selected and configured all the necessary attributes, such as start_url and others, but it still doesn’t work.

Answered: Does Headwind Application Settings support Zebra OEMConfig?

Thu, 08 Jan 2026 15:16:07 +0000

Headwind MDM supports Zebra OEMConfig (through application settings) since version 6.29. See details here: https://h-mdm.com/zebra/#oemconfig

Answered: Intent - custom command?

Wed, 07 Jan 2026 08:12:44 +0000

Yes, this is a correct configuration. There are two types of intents supported by Headwind MDM. The first one is sending an intent to a specific app (type runApp), and the second is a system intent like android.intent.action.VIEW (type intent).

Besides action and data, you can add extra in a similar way as described here.

If it doesn't work, update Headwind MDM launcher to the latest version, or contact the technical support for assistance.

Answered: Configuration of the Photo plugin

Wed, 07 Jan 2026 07:35:04 +0000

To use the photo plugin (available in Headwind MDM Premium and Enterprise), request the technical support for the mobile agent APK, and add it to all relevant configurations.

To configure the plugin, open Settings - Photos.

The following options are available:

Transfer photos to server - set this flag to activate the mobile agent

Paths to images - if you need to retrieve images from non-standard places (standard are DCIM/Camera and DCIM/100ANDRO), list them here.

Paths that do not require transmission - this field can be used to rotate files in the directory (remove old files) without transmission to the server.

Include standard image paths - set this flag to retrieve images from DCIM/Camera and DCIM/100ANDRO.

Get non-image files - additional file extensions in case you'd like to transfer non-image files.

Directory structure on the server - specify the directory structure on the server where images are stored

File name template - specify the template for file names on the server (NAME is the original file name on the device).

Remove old files (days) - use this parameter to remove old files on the server (0 - do not remove).

Delete images on devices - configure the file rotation parameters on devices.

Image Location - set this flag to geotag images.

Disable Location Warning - a custom warning text prompting user to turn on location tracking.

Add label - set this flag to add the location text label to images.

Label color, Background Color, Transparency - text label parameters.

Label Text - configure the template of the text label (address is determined from the geolocation by the Android OS built-in method).

If you have configured everything, but the Photo plugin still doesn't work properly:

- Run the photo plugin mobile agent APK manually

- Add verbose logging for the com.hmdm.sendphoto package and track the mobile agent work in Functions - Logs.

the APN app is not working properly, can you provide update version ?

Tue, 06 Jan 2026 15:39:17 +0000

the APN app version 1.03 Failed to add APN

error

Failed to set up APN: Not Allowed to add APN

Make sur Headwind MDM is installed with device owner rights!

I have checked the permissions and allow it all

https://github.com/h-mdm/hmdm-plugin-apn

in this link i can see version 1.04 but no APK released

can some one provide updated version ?

Automate changing device configurations

Tue, 06 Jan 2026 07:48:20 +0000

Can a Scheduled Task be configured to automate changing configurations of devices?

Scheduled Tasks - 'intent' command.

Mon, 05 Jan 2026 22:40:04 +0000

Can Scheduled Tasks be configured to run an 'intent' command, similar to Push Messages?

List of URLs accessed by devices

Mon, 05 Jan 2026 16:56:09 +0000

For additional protection of our Headwind MDM instance, I would like to limit access to the web panel.

However I need to exclude URLs accessed by devices.

Can you please tell me which URLs should be available to devices and therefore must be excluded from this restriction?

Play Protect is blocking headwind inspired custom MDM app

Tue, 23 Dec 2025 06:53:41 +0000

I had developed a custom MDM app inspired from Headwind MDM source code. Problem now is google is blocking this app, as this is accessing sensitive information of the device.

I have seen many posts facing this issue. Can anyone help me install the MDM app via QR code provisioning by solving this error ?

I have tried removing unnecessary permission from manifest. But still unable to bypass this !

Thanks in advance

Deploy scanemul profile with headwind

Thu, 18 Dec 2025 09:16:10 +0000

Hello,

we would like to deploy a Scenemul profile via Headwind. Could you please advise on the correct procedure for doing this on a M3 Mobile SM20 running Android 11 with Scanemul version V4.1.18 ?

Please note that with this Android version, writing to /Android/data/... is restricted due to Android platform limitations.

Get logs from a specific application

Wed, 17 Dec 2025 20:51:39 +0000

Currently I get the log from the MDM launcher (com.hmdm.launcher) which I added from the Settings\Logs module of the WebPanel.

However, when I add another application, its logs are not recorded.

Is it possible to obtain the logs of a specific application?

Deploy datawedge profile with headwind

Wed, 17 Dec 2025 09:19:01 +0000

Hello,

we would like to deploy a DataWedge profile via Headwind. Could you please advise on the correct procedure for doing this on a Zebra TC27 running Android 14 with DataWedge version 13?

Please note that with this Android version, writing to /Android/data/... is restricted due to Android platform limitations.

Can I Develop/Install Plugins on HMDM with the Free Version?

Tue, 16 Dec 2025 12:55:05 +0000

I was wondering if it is possible to develop and install custom plugins on my server while using the free version of HMDM. Also, would I be able to add plugins created by other users?

remote control page is stuck on loading with setup written on it.

Tue, 16 Dec 2025 11:41:16 +0000

i have deployed enterprise HMDM and remote control(https://mdm.appstore.et/web-admin) page is stuck on loading with setup written on it.