This document provides troubleshooting steps for resolving enrollment failures when enrolling Debian 12 (Bookworm) devices into the SureMDM console. In certain environments, the SureMDM enrollment process may fail due to a missing system dependency required by the SureMDM Linux agent.
Purpose
The purpose of this document is to guide administrators through resolving enrollment failures caused by the absence of the libfuse2 package on Debian 12 systems, allowing successful installation and enrollment of the SureMDM Linux agent.
Issue Description
During the installation or enrollment of the SureMDM Linux agent on Debian 12 devices, the enrollment process may fail with an error similar to:
libfuse2 integrity failed: cannot proceed with verification
or
Missing dependency: libfuse2
As Debian 12 no longer includes the libfuse2 package by default, the SureMDM installer may be unable to complete the verification process, resulting in enrollment failure.
As a result, the SureMDM installer cannot complete the verification process until the required dependency is installed.
Resolution
Method 1: Temporarily Add the Debian 11 (Bullseye) Repository
- Add the Debian 11 Bullseye repository:
echo “deb http://deb.debian.org/debian bullseye main” | sudo tee /etc/apt/sources.list.d/bullseye.list
- Update the package repository:
sudo apt update
- Install the libfuse2 package:
sudo apt install -y libfuse2
Method 2: Download and Install the Package Directly
Alternatively, download and install the package manually:
curl -fsSL -o /tmp/libfuse2_bullseye.deb \
“http://deb.debian.org/debian/pool/main/f/fuse/libfuse2_2.9.9-5_amd64.deb”
Install the package:
sudo apt install /tmp/libfuse2_bullseye.deb
After successfully installing libfuse2, execute the SureMDM Linux installation and enrollment CLI command generated from the SureMDM console.
Once the device has been successfully enrolled into SureMDM, it is recommended to remove the temporary Bullseye repository to avoid unintended package installations from an older Debian release.
Remove the repository:
sudo rm /etc/apt/sources.list.d/bullseye.list
Update the package lists:
sudo apt update
Need more help? Here’s how to get help from our experts.