Elgato_dark/fleet
1
0
Fork 0
mirror of https://github.com/fleetdm/fleet synced 2026-04-21 21:47:20 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 117
fleet/articles/windows-linux-setup-experience.md
Noah Talerman 7e963b038b
Linux setup experience > Install software: What does "compatible platforms" mean? (#40510) 
<img width="1072" height="664" alt="Screenshot 2026-02-25 at 12 53
42 PM"
src="https://github.com/user-attachments/assets/3e5fde32-5b75-4e69-93d9-0b1e89badf3b"
/>
2026-03-11 15:20:49 -07:00

4.5 KiB
Raw Blame History

Windows & Linux setup experience

Available in Fleet Premium

In Fleet, you can customize the out-of-the-box Windows and Linux setup.

Currently, Windows setup experience is only supported for manual enrollments. Automatic enrollment and Autopilot support is coming soon.

Currently, Linux setup experience is only supported for Ubuntu, Debian, Fedora, Amazon Linux, CentOS, openSUSE, and Red Hat Enterprise Linux (RHEL).

Here's what you can configure, and in what order each happen, to your Windows and Linux hosts during setup:

  1. Require end users to authenticate with your identity provider (IdP).

  2. Install software including app store apps, custom packages (e.g. a bootstrap package), and Fleet-maintained apps.

Below is the end user experience for Linux. Check out the separate video for Windows.

End user authentication

End user experience

Fleet automatically opens the default web browser and directs the end user to log in before the setup process can continue. Learn how to enforce authentication in the setup experience guide.

When wiping and re-enrolling a host, delete the host from Fleet as well. Otherwise, end user authentication won’t be enforced when it re-enrolls.

If the Fleet agent (fleetd) installed on the host is older than version 1.50.0, end user authentication won't be enforced.

Install software

End user experience

Fleet automatically opens the default web browser to show end users software install progress:

screen shot of Fleet setup experience webpage

The browser can be closed, and the installation will continue in the background. End users can return to the setup experience page by clicking My Device from Fleet Desktop. Once all steps have completed, the My Device page will show the host information as usual.

For Linux, Fleet automatically installs on compatible platforms. This means .deb packages are only installed on Ubuntu and Debian hosts. .rpm packages are only installed on Fedora, CentOS, Amazon Linux, and Red Hat Enterprise Linux (RHEL).

If software installs fail, Fleet automatically retries. Learn more in the setup experience guide.

To replace the Fleet logo with your organization's logo:

  1. Go to Settings > Organization settings > Organization info
  2. Add URLs to your logos in the Organization avatar URL (for dark backgrounds) and Organization avatar URL (for light backgrounds) fields
  3. Press Save

See configuration documentation for recommended logo sizes.

Software installations during setup experience are automatically attempted up to 3 times (1 initial attempt + 2 retries) to handle intermittent network issues or temporary failures. This ensures a more reliable setup process for end users.

Add software

Add setup experience software setup experience:

  1. Click on the Controls tab in the main navigation bar, then Setup experience > 3. Install software.
  2. Click on the tab corresponding to the operating system (e.g. Linux).
  3. Click Add software, then select or search for the software you want installed during the setup experience.
  4. Press Save to save your selection.

Fleet also provides a API endpoints for managing setup experience software programmatically. Learn more in Fleet's API reference.