Choosing the Right Installer Type
Choosing the correct installer type is essential for successfully enrolling a device. Installers are built for specific operating systems, architectures, and, in some cases, distribution types. Using the wrong installer is one of the most common reasons an installation fails.
This guide explains how to select the right installer before downloading or running it on a device.
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.
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.
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, and distribution ensures that the agent can install properly and run reliably.
Using the correct installer 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.
Taking a moment to confirm these details before downloading an installer can save time and prevent troubleshooting later in the setup process.