fleet/articles/windows-linux-setup-experience.md

Install software during new Linux setup

Available in Fleet Premium

In Fleet, you can customize the software that's installed when a new Linux workstations enrolls to Fleet This feature is similar to the setup experience available on macOS during ADE enrollment. Windows support is coming soon.

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

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.

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.

Choose software

To pick which software is installed during the 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 you're configuring, either macOS, or 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.