Edit

Identify an Azure Linux system and version

Use standard Linux and Azure tools to identify the operating system, architecture, kernel, installed RPM packages, and available Azure Marketplace VM images.

Product name

Azure Linux 4 is the product name for the general-purpose, package-managed Linux distribution. Don't use Mariner 4.0 or CBL-Mariner 4.0 as product names.

Identify the operating system

Read /etc/os-release to identify the distribution and major version:

cat /etc/os-release

Use the fields instead of parsing the human-readable text. An Azure Linux 4 system reports:

NAME="Azure Linux"
ID=azurelinux
VERSION_ID="4.0"

Build-specific fields can change as the system is updated. Don't use /etc/mariner-release as the Azure Linux 4 identity source.

Identify the architecture

Run:

uname -m

Azure Linux 4 VM images are available for the following 64-bit architectures:

uname -m value Architecture name
x86_64 x64 or AMD64
aarch64 ARM64

Identify the kernel

Display the running kernel release:

uname -r

Display the installed kernel RPM packages:

rpm -q kernel
dnf info --installed kernel

Kernel release and RPM version strings change through servicing. Use the complete value when you report an issue instead of relying on only the upstream kernel version.

Identify package versions and repositories

Display an installed package's name, epoch, version, release, architecture, and source repository:

rpm -q --qf '%{NAME}-%{EPOCHNUM}:%{VERSION}-%{RELEASE}.%{ARCH}\n' <PACKAGE_NAME>
dnf info --installed <PACKAGE_NAME>
dnf repoquery --installed --info <PACKAGE_NAME>

Azure Linux RPM release strings commonly include an azl4 distribution suffix. Treat the full RPM identifier as the package version.

Identify Azure Marketplace VM images

Azure Linux 4 VM images use these Marketplace identifiers:

Architecture Publisher Offer SKU URN using the latest version
x64, Gen2 microsoftazurelinux azurelinux-4 4 microsoftazurelinux:azurelinux-4:4:latest
ARM64, Gen2 microsoftazurelinux azurelinux-4 4-arm64 microsoftazurelinux:azurelinux-4:4-arm64:latest

List the versions available in a region:

az vm image list \
  --location <REGION> \
  --publisher microsoftazurelinux \
  --offer azurelinux-4 \
  --sku 4 \
  --all \
  --output table

For ARM64, replace --sku 4 with --sku 4-arm64.

Use latest when you want Azure to resolve the current image at deployment time. Use a version returned by az vm image list when you need to select an explicit Marketplace image version.

Collect identification details for support

When you report an issue, include:

  • Relevant fields from /etc/os-release.
  • Output from uname -m and uname -r.
  • The full RPM identifier for affected packages.
  • The Marketplace image URN or version used to create the VM, if available.
  • Whether the system is an unmodified Marketplace image or a custom image.

If Microsoft Support requests a diagnostic archive, follow Collect diagnostic information to generate and provide an sos report.