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 416123e638
Guide: Windows setup experience for automatic enrollment / Autopilot is coming soon (#39599) 
We designed the setup experience for manual enrollments for agent
install, we haven't got to the automatic piece.

Support for automatic enrollment + Autopilot is coming in this story:
https://github.com/fleetdm/fleet/issues/38785
2026-02-13 09:39:22 -05:00

3.7 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.

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.

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.

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.

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.