Skip to content

Revise supported Linux distributions and versions #1951

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
yanchoyanev wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Revise supported Linux distributions and versions #1951

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 10 additions & 10 deletions docs/identity/devices/howto-vm-sign-in-azure-ad-linux.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -33,18 +33,18 @@ The following Linux distributions are currently supported for deployments in a s

| Distribution | Version |
| --- | --- |
| AlmaLinux | AlmaLinux 8, AlmaLinux 9 |
| Azure Linux (formerly known as Common Base Linux Mariner)| CBL-Mariner 2.0, Azure Linux 3.0 |
| Debian | Debian 9, Debian 10, Debian 11, Debian 12 |
| openSUSE | openSUSE Leap 42.3, openSUSE Leap 15.1 to 15.5, openSUSE Leap 15.6+ |
| Oracle | Oracle Linux 8, Oracle Linux 9 |
| RedHat Enterprise Linux (RHEL) | RHEL 7.4 to RHEL 7.9, RHEL 8.3+, RHEL 9.0+ |
| Rocky | Rocky 8, Rocky 9 |
| SUSE Linux Enterprise Server (SLES) | SLES 12, SLES 15.1 to 15.5, SLES 15.6+ |
| Ubuntu | Ubuntu 16.04 to Ubuntu 24.04 |
| AlmaLinux | 8+ |
| Azure Linux (formerly known as Common Base Linux Mariner)| 2.0, 3.0 |
Copy link

Copilot AI Apr 22, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The Azure Linux table row is missing a space before the column separator (|) after the distribution name, which makes the table formatting inconsistent and can impact readability. Add a space before the | to match the other rows.

Suggested change
| Azure Linux (formerly known as Common Base Linux Mariner)| 2.0, 3.0 |
| Azure Linux (formerly known as Common Base Linux Mariner) | 2.0, 3.0 |

Copilot uses AI. Check for mistakes.
| Debian | 9+ |
| openSUSE | openSUSE Leap 42.3, 15+ |
| Oracle | 8+ |
| RedHat Enterprise Linux (RHEL) | 7.4 to 7.9, 8.3+ |
Copy link

Copilot AI Apr 22, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Possible regression/ambiguity in the RHEL support row: previously the table explicitly listed RHEL 9.0+ as supported, but the new entry only mentions 7.4–7.9 and 8.3+. If RHEL 9 is still supported, update the row to include it; if it’s intentionally no longer supported, consider calling that breaking change out explicitly to avoid confusing readers.

Suggested change
| RedHat Enterprise Linux (RHEL) | 7.4 to 7.9, 8.3+ |
| RedHat Enterprise Linux (RHEL) | 7.4 to 7.9, 8.3+, 9.0+ |

Copilot uses AI. Check for mistakes.
| Rocky | 8+ |
| SUSE Linux Enterprise Server (SLES) | 12, 15.1+ |
| Ubuntu | 16.04+ |

> [!NOTE]
> SUSE made a breaking change with version 15.6 that is incompatible with the older versions. Since the Microsoft Entra login VM extension always installs the latest package, this will not work on older SUSE versions. You can install the aadsshlogin packages from packages.microsoft.com for older SUSE versions. After adding the repo, one can manually install them with this command: `sudo zypper install aadsshlogin=1.0.027980001`.
> There was a breaking change on EL-like distribution on version 9.6, as well as on SUSE 15.6 that is incompatible with versions 9.0-9.5 or 15.0-15.6 respectively. Since http://packages.microsoft.com does not provide repositories for each minor version, the VM extension was modified to not install the latests version of aadsshlogin package. Staying on these version can pose a security risk as it does not allow making hotfixes to our packages. Also, you should avoid calling any cpommand that will result to upgrading aadsshlogin package, because it can render the machine unusable.
Copy link

Copilot AI Apr 22, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Typo: "latests" should be "latest".

Suggested change
> There was a breaking change on EL-like distribution on version 9.6, as well as on SUSE 15.6 that is incompatible with versions 9.0-9.5 or 15.0-15.6 respectively. Since http://packages.microsoft.com does not provide repositories for each minor version, the VM extension was modified to not install the latests version of aadsshlogin package. Staying on these version can pose a security risk as it does not allow making hotfixes to our packages. Also, you should avoid calling any cpommand that will result to upgrading aadsshlogin package, because it can render the machine unusable.
> There was a breaking change on EL-like distribution on version 9.6, as well as on SUSE 15.6 that is incompatible with versions 9.0-9.5 or 15.0-15.6 respectively. Since http://packages.microsoft.com does not provide repositories for each minor version, the VM extension was modified to not install the latest version of aadsshlogin package. Staying on these version can pose a security risk as it does not allow making hotfixes to our packages. Also, you should avoid calling any cpommand that will result to upgrading aadsshlogin package, because it can render the machine unusable.

Copilot uses AI. Check for mistakes.
Copy link

Copilot AI Apr 22, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Typo: "cpommand" should be "command".

Suggested change
> There was a breaking change on EL-like distribution on version 9.6, as well as on SUSE 15.6 that is incompatible with versions 9.0-9.5 or 15.0-15.6 respectively. Since http://packages.microsoft.com does not provide repositories for each minor version, the VM extension was modified to not install the latests version of aadsshlogin package. Staying on these version can pose a security risk as it does not allow making hotfixes to our packages. Also, you should avoid calling any cpommand that will result to upgrading aadsshlogin package, because it can render the machine unusable.
> There was a breaking change on EL-like distribution on version 9.6, as well as on SUSE 15.6 that is incompatible with versions 9.0-9.5 or 15.0-15.6 respectively. Since http://packages.microsoft.com does not provide repositories for each minor version, the VM extension was modified to not install the latests version of aadsshlogin package. Staying on these version can pose a security risk as it does not allow making hotfixes to our packages. Also, you should avoid calling any command that will result to upgrading aadsshlogin package, because it can render the machine unusable.

Copilot uses AI. Check for mistakes.
Copy link

Copilot AI Apr 22, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The new NOTE is difficult to follow and has a few correctness/clarity issues: it uses singular/ambiguous wording ("EL-like distribution"), the version ranges appear self-contradictory (for example, "15.0-15.6" includes 15.6), and it uses an http:// URL for packages.microsoft.com (elsewhere in the doc it’s https://). Please rewrite this note to clearly state which distros/minor versions are affected, what the recommended action is, and format the packages URL consistently (prefer https:// and appropriate Markdown formatting).

Suggested change
> There was a breaking change on EL-like distribution on version 9.6, as well as on SUSE 15.6 that is incompatible with versions 9.0-9.5 or 15.0-15.6 respectively. Since http://packages.microsoft.com does not provide repositories for each minor version, the VM extension was modified to not install the latests version of aadsshlogin package. Staying on these version can pose a security risk as it does not allow making hotfixes to our packages. Also, you should avoid calling any cpommand that will result to upgrading aadsshlogin package, because it can render the machine unusable.
> A breaking change affects Enterprise Linux 9.6 distributions, such as RHEL 9.6 and compatible derivatives, and SUSE Linux Enterprise Server 15.6. These releases aren't compatible with `aadsshlogin` package builds intended for earlier minor versions in the same distribution family, such as Enterprise Linux 9.0 through 9.5 and SLES 15.0 through 15.5. Because [packages.microsoft.com](https://packages.microsoft.com/) doesn't provide repositories for every minor version, the VM extension installs an earlier `aadsshlogin` package version on these systems instead of the latest version. To avoid making the machine unusable, don't manually upgrade `aadsshlogin` on affected systems. Stay on the extension-installed version until a compatible package version is available.

Copilot uses AI. Check for mistakes.

The following Azure regions are currently supported for this feature:

Expand Down