fleet/docs/Using Fleet/Supported-host-operating-systems.md
Lucas Manuel Rodriguez bb310e685d
Support Ubuntu 24.04 with Xorg (by detecting user's DISPLAY environment variable) (#18996)
#18925 (Should also fix #17660.)

Tests:
- Ubuntu 22.04.2
	- Wayland
		- Works with chrome  
		- Doesn't work with Firefox. 
	- Xorg
		- Works with Chrome.  
		- Works with Firefox. 
- Ubuntu 24.04
	- Wayland
		- Doesn't work with Chrome. 
		- Doesn't work with Firefox. 
- Xorg (when using Xorg it defaults to `DISPLAY=:1`, and with the
changes in this PR it works):
		- Works with Chrome.  
		- Works with Firefox.  
---

How to change between Wayland and Xorg:

- Set `WaylandEnable=false` in `/etc/gdm3/custom.conf` and reboot.

---

How to determine what's running:
```sh
$ loginctl
SESSION  UID USER SEAT  TTY 
      2 1000 luk  seat0 tty2
     c2 1000 luk        

$ loginctl show-session 2 -p Type
# will output
Type=wayland
or
Type=x11
```
---

- [X] Changes file added for user-visible changes in `changes/`,
`orbit/changes/` or `ee/fleetd-chrome/changes`.
See [Changes
files](https://fleetdm.com/docs/contributing/committing-changes#changes-files)
for more information.
- [X] Added/updated tests
- [X] Manual QA for all new/changed functionality
  - For Orbit and Fleet Desktop changes:
- [X] Manual QA must be performed in the three main OSs, macOS, Windows
and Linux.
- [x] Auto-update manual QA, from released version of component to new
version (see [tools/tuf/test](../tools/tuf/test/README.md)).
2024-05-16 08:39:30 -03:00

1.9 KiB

Supported host operating systems

Fleet supports the following operating system versions on hosts.

OS Supported version(s)
macOS 13 (Ventura) and higher
Windows 10 (Pro and Enterprise) and higher
Linux CentOS 7.1+, Ubuntu 20.04+, Fedora 38+
ChromeOS 112.0.5615.134+

While Fleet may still function partially or fully with OS versions older than those above, Fleet does not actively test against unsupported versions and does not pursue bugs on them.

Some notes on compatibility

Tables

Not all osquery tables are available for every OS. Please check out the osquery schema for detailed information.

If a table is not available for your host, Fleet will generally handle things behind the scenes for you.

M1 Macs

Fleet's agent (fleetd) generated for MacOS by fleetctl package does not include native support for M1 Macs. Some values returned may reflect the information returned by Rosetta rather than the system. For example, a CPU will show up as i486.

Linux

Ubuntu Linux: Fleet Desktop currently supports Xorg as X11 server, Wayland is currently not supported. Ubuntu 24.04 comes with Wayland enabled by default. To use X11 instead of Wayland you can set WaylandEnable=false in /etc/gdm3/custom.conf and reboot.

Fedora, CentOS 8 and 9 require a gnome extension and Google Chrome set to the default browser for Fleet Desktop.

The fleetctl package command is not supported on DISA-STIG distribution.