Choosing the Right Installer Type
Choosing the correct installer type is essential for successfully enrolling a device. The installer wizard walks you through operating system, architecture, and policy choices so you can generate the right installer for each device.
Using the wrong combination is one of the most common reasons an installation fails or does not appear in your Dashboard as expected.
Use the Installer Wizard
Installer creation is guided step by step. You will select the platform and options shown for that operating system, then confirm before generation.
The exact options in the wizard can vary by operating system, so it is normal for some paths to include different selections than others.
Operating System
The first decision is the device’s operating system. Installers are created specifically for each supported platform, such as Windows, macOS, or Linux.
An installer built for one operating system will not run on another, even if the device hardware is similar.
System Architecture
Installers are also architecture-specific. Most modern systems use a 64-bit architecture, but this should always be confirmed where applicable.
Common architectures include:
- 64-bit (x64 / amd64)
- ARM-based architectures (on supported platforms)
An installer built for a different architecture will fail to run or exit immediately.
Policy Selection
The wizard includes policy selection for installer generation. This ensures each device is enrolled with the intended protection behavior from the start.
For macOS, policy delivery is MDM-based and uses role-driven policy types (for example, Workstation or Server). If a required macOS MDM policy is not yet available, you can request notification and generate once it is available.
Linux Distribution Type
On Linux systems, installers may be further tailored to specific distribution families.
Different Linux distributions use different package managers and system layouts, which means an installer built for one distribution family may not work on another.
Before selecting a Linux installer, confirm the device’s distribution type and version.
Why This Matters
Matching the installer to the correct operating system, architecture, policy, and Linux distribution (when applicable) ensures the agent can install properly and run reliably.
Using the correct options avoids failed installs, incomplete setups, and devices not appearing in the Dashboard.
If You Are Unsure
If you are not sure which installer to choose, verify the device’s operating system and architecture before proceeding.
Then follow the wizard selections carefully for policy and any OS-specific options. Taking a moment to confirm these details can save time and prevent troubleshooting later.