Install Lustre client software

In this article, you learn how to install a Lustre client package. After you install the package, you can set up client virtual machines (VMs) and attach them to an Azure Managed Lustre cluster. Select an operating system version to see the instructions.

Before you install, see Plan your Lustre client installation for the support matrix and to choose between the prebuilt kmod and DKMS install methods.

If you need to upgrade an existing Lustre client to the current version, see Upgrade Lustre client software to the current version.

For more information on connecting clients to a cluster, see Connect clients to an Azure Managed Lustre file system.

For more information about the behavior of Azure Managed Lustre with Trusted Launch Virtual Machines and Confidential Compute Virtual Machines, refer to Use Secure Boot with Azure Managed Lustre file system.

Upgrade client software for AlmaLinux HPC 8.6

This article shows how to install the client package to set up client VMs running AlmaLinux HPC 8.6.

Install client software for Red Hat Enterprise Linux 7

This article shows how to install the client package to set up client VMs running Red Hat Enterprise Linux 7 (RHEL 7).

Install client software for Red Hat Enterprise Linux 8 or AlmaLinux 8

This article shows how to install the client package to set up client VMs running Red Hat Enterprise Linux 8 (RHEL 8) or AlmaLinux 8.

Note

For AlmaLinux 8.6 HPC images in Azure Marketplace, see the separate AlmaLinux 8.6 HPC installation instructions.

Install client software for Red Hat Enterprise Linux 9 or AlmaLinux 9

This article shows how to install the client package to set up client VMs running Red Hat Enterprise Linux 9 (RHEL 9) or AlmaLinux 9.

Install client software for Ubuntu 18.04

This article shows how to install the client package to set up client VMs running Ubuntu 18.04.

Install client software for Ubuntu 20.04

This article shows how to install the client package to set up client VMs running Ubuntu 20.04.

Install client software for Ubuntu 22.04

This article shows how to install the client package to set up client VMs running Ubuntu 22.04.

Install client software for Ubuntu 24.04

This article shows how to install the client package to set up client VMs running Ubuntu 24.04.

Install client software for Azure Linux 3

This article shows how to install the client package to set up client VMs running Azure Linux 3.

Download and install client software

Warning

These instructions apply only to the AlmaLinux 8.6 HPC images in Azure Marketplace. For all other AlmaLinux 8 installations, including HPC and general marketplace, refer to the Red Hat 8 instructions.

Install and configure the Azure Managed Lustre repository for the DNF package manager. Create the following script and name it repo.bash:

#!/bin/bash
set -ex

rpm --import https://packages.microsoft.com/keys/microsoft.asc

DISTRIB_CODENAME=el8

REPO_PATH=/etc/yum.repos.d/amlfs.repo
echo -e "[amlfs]" > ${REPO_PATH}
echo -e "name=Azure Lustre Packages" >> ${REPO_PATH}
echo -e "baseurl=https://packages.microsoft.com/yumrepos/amlfs-${DISTRIB_CODENAME}" >> ${REPO_PATH}
echo -e "enabled=1" >> ${REPO_PATH}
echo -e "gpgcheck=1" >> ${REPO_PATH}
echo -e "gpgkey=https://packages.microsoft.com/keys/microsoft.asc" >> ${REPO_PATH}

Run the script as a superuser:
```
sudo bash repo.bash
```
Install the metapackage that matches your running kernel:
```
sudo dnf install --disableexcludes=main --refresh amlfs-lustre-client-2.15.8_34_gc0f2040-$(uname -r | sed -e "s/\.$(uname -p)$//" | sed -re 's/[-_]/\./g')-1
```
Note

The metapackage version doesn't always align with the kernel version. Use the preceding command to install the proper metapackage.

If you want to upgrade only the kernel and not all packages, you must (at minimum) also upgrade the amlfs-lustre-client metapackage so that the Lustre client can continue to work after the restart. The command should look similar to the following example:
```
export NEWKERNELVERSION=6.7.8
sudo dnf upgrade kernel-$NEWKERNELVERSION amlfs-lustre-client-2.15.8_34_gc0f2040-$(echo $NEWKERNELVERSION | sed -e "s/\.$(uname -p)$//" | sed -re 's/[-_]/\./g')-1
```

Warning

We're no longer publishing new client packages for Red Hat Enterprise Linux 7. Please migrate to one of the supported releases to run newer versions of the Azure Managed Lustre client packages.

Install and configure the Azure Managed Lustre repository for the YUM package manager. Create the following script and name it repo.bash:

#!/bin/bash
set -ex

rpm --import https://packages.microsoft.com/keys/microsoft.asc

DISTRIB_CODENAME=el7

REPO_PATH=/etc/yum.repos.d/amlfs.repo
echo -e "[amlfs]" > ${REPO_PATH}
echo -e "name=Azure Lustre Packages" >> ${REPO_PATH}
echo -e "baseurl=https://packages.microsoft.com/yumrepos/amlfs-${DISTRIB_CODENAME}" >> ${REPO_PATH}
echo -e "enabled=1" >> ${REPO_PATH}
echo -e "gpgcheck=1" >> ${REPO_PATH}
echo -e "gpgkey=https://packages.microsoft.com/keys/microsoft.asc" >> ${REPO_PATH}

Run the script as a superuser:
```
sudo bash repo.bash
```
Install the metapackage that matches your running kernel.

The metapackage version doesn't always align with the kernel version. You can use the following command to install the proper metapackage:
```
sudo yum install amlfs-lustre-client-2.15.4_42_gd6d405d-$(uname -r | sed -e "s/\.$(uname -p)$//" | sed -re 's/[-_]/\./g')-1
```
Note

Running dnf search amlfs-lustre-client doesn't show all available packages for your distribution. To see all available amlfs-lustre-client packages, run dnf list --showduplicates "amlfs-lustre-client*".

If you want to upgrade only the kernel and not all packages, you must (at minimum) also upgrade the amlfs-lustre-client metapackage so that the Lustre client can continue to work after the restart. The command should look similar to the following example:
```
export NEWKERNELVERSION=6.7.8
sudo yum upgrade kernel-$NEWKERNELVERSION amlfs-lustre-client-2.15.4_42_gd6d405d-$(echo $NEWKERNELVERSION | sed -e "s/\.$(uname -p)$//" | sed -re 's/[-_]/\./g')-1
```

Important

Microsoft recommends running on RHEL/AlmaLinux 8.10, the latest (and terminal) RHEL 8 minor release. RHEL 8 is in Maintenance Support phase, and Red Hat ships security errata only for 8.10. Older 8.x minors (8.6 through 8.9) no longer receive Red Hat errata.

Verify the running RHEL minor version:
```
cat /etc/redhat-release
```
Expected output for a RHEL 8.10 system:
```
Red Hat Enterprise Linux release 8.10 (Ootpa)
```
If the system is on an older 8.x minor, upgrade to 8.10:
```
sudo dnf upgrade --refresh -y
sudo reboot
```
Note

If the system was previously locked to an older minor with subscription-manager release --set=8.x (for example, a paid RHEL 8.6 or 8.8 EUS pin), the upgrade above is blocked by that release lock. Check with sudo subscription-manager release --show. To allow the move to 8.10, run sudo subscription-manager release --unset before the upgrade. RHEL 8 EUS support ended May 31, 2025, so a pre-existing 8.x EUS pin no longer receives security updates.

Install and configure the Azure Managed Lustre repository for the DNF package manager. Create the following script and name it repo.bash:

#!/bin/bash
set -ex

rpm --import https://packages.microsoft.com/keys/microsoft.asc

DISTRIB_CODENAME=el8

REPO_PATH=/etc/yum.repos.d/amlfs.repo
echo -e "[amlfs]" > ${REPO_PATH}
echo -e "name=Azure Lustre Packages" >> ${REPO_PATH}
echo -e "baseurl=https://packages.microsoft.com/yumrepos/amlfs-${DISTRIB_CODENAME}" >> ${REPO_PATH}
echo -e "enabled=1" >> ${REPO_PATH}
echo -e "gpgcheck=1" >> ${REPO_PATH}
echo -e "gpgkey=https://packages.microsoft.com/keys/microsoft.asc" >> ${REPO_PATH}

Run the script as a superuser:
```
sudo bash repo.bash
```
Install the Lustre client package. Choose the install method that best fits your needs:
- Prebuilt kmod
- DKMS
The metapackage version doesn't always align with the kernel version. Use the following command to install the proper metapackage:
```
sudo dnf install amlfs-lustre-client-2.15.8_34_gc0f2040-$(uname -r | sed -e "s/\.$(uname -p)$//" | sed -re 's/[-_]/\./g')-1
```
Note

Running dnf search amlfs-lustre-client doesn't show all available packages for your distribution. To see all available amlfs-lustre-client packages, run dnf list --showduplicates "amlfs-lustre-client*".

If you want to upgrade only the kernel and not all packages, you must (at minimum) also upgrade the amlfs-lustre-client metapackage so that the Lustre client can continue to work after the restart. The command should look similar to the following example:
```
export NEWKERNELVERSION=6.7.8
sudo dnf upgrade kernel-$NEWKERNELVERSION amlfs-lustre-client-2.15.8_34_gc0f2040-$(echo $NEWKERNELVERSION | sed -e "s/\.$(uname -p)$//" | sed -re 's/[-_]/\./g')-1
```
```
sudo dnf install -y lustre-client-dkms-2.15.8_35_gdf4872c
```
This DKMS package automatically includes the matching Lustre userspace tools package (lustre-client) as a dependency. So, a single dnf install command gives you both the module source and the userspace tools.

The DKMS package automatically compiles the Lustre kernel module for your running kernel. Unlike the prebuilt kmod package, you don't need to match a specific kernel version or use sed to transform the kernel version string. DKMS rebuilds the module automatically when your kernel is upgraded.

Note

DKMS requires kernel headers (kernel-devel), GCC, and Make to be installed. The package dependencies handle this requirement automatically, but the initial install takes a few minutes while the kernel module compiles.

Important

Azure Managed Lustre client packages don't yet support RHEL/AlmaLinux 9.8 (released May 19, 2026). Support is expected to land with the upcoming Lustre 2.15.9 release. Before installing the Lustre client, make sure your VM is on a supported minor release. Check the Support matrix for the current list — 9.8 will be listed there once Azure Managed Lustre packages ship for it.

Important

For production workloads, Microsoft recommends pinning RHEL 9 systems to a Red Hat Extended Update Support (EUS) minor release before installing the Lustre client. Pinning keeps the kernel inside a stable z-stream that Microsoft actively validates the Lustre client against.

The currently recommended minor for RHEL 9 is 9.6 EUS (EUS support ends May 31, 2027). For the current list of RHEL EUS minor releases, see Red Hat Enterprise Linux Life Cycle. For the AMLFS-tested kernel series for each RHEL/AlmaLinux 9 minor, see the Support matrix.

AlmaLinux 9 doesn't have an EUS program. For the same stability reasons, Microsoft recommends pinning AlmaLinux 9 to a specific minor release (currently 9.6) so the kernel doesn't roll forward unexpectedly.

If the VM was deployed from the RHEL 9.6 EUS image in the Azure Marketplace, EUS is already configured and you can skip the pinning step.

Important

The procedure below pins the system at its current running minor — it doesn't change which minor the system is on. If cat /etc/redhat-release reports a minor newer than 9.6, this article doesn't cover the rollback.

The most reliable path is to deploy a new VM from the RHEL 9.6 EUS image in the Azure Marketplace (or, for AlmaLinux, from a 9.6 image) and re-install the Lustre client there. In-place rollback to an earlier minor depends on the system's subscription type, RHUI versus BYOS configuration, and EUS entitlement; refer to Red Hat documentation or your Red Hat support channel for downgrade procedures.

Pin the system to a supported minor release so the kernel doesn't roll forward into an unsupported minor on the next update.

Use the method that matches your deployment.

RHEL with Red Hat Subscription Manager (BYOS or on-premises):
```
sudo subscription-manager release --set=9.6
sudo subscription-manager repos \
    --disable=rhel-9-for-x86_64-baseos-rpms \
    --disable=rhel-9-for-x86_64-appstream-rpms \
    --enable=rhel-9-for-x86_64-baseos-eus-rpms \
    --enable=rhel-9-for-x86_64-appstream-eus-rpms
sudo dnf clean all && sudo dnf makecache
```
EUS requires a subscription with the EUS entitlement. Red Hat Enterprise Linux Server Premium subscriptions include EUS; Standard subscriptions require the EUS add-on.

RHEL on Azure with pay-as-you-go (RHUI) billing:

For PAYG VMs that use Azure RHUI, follow the Microsoft Azure procedure in Switch a RHEL Server to EUS Repositories. Use 9.6 as the releasever value in the lock step.

Note

Flipping RHUI repositories in place doesn't change how Azure bills the VM. For correct billing, deploy a fresh VM from the RHEL 9.6 EUS Azure Marketplace image.

AlmaLinux 9 (minor-version pin, not EUS):

AlmaLinux 9 doesn't offer EUS. The steps below pin DNF's releasever to 9.6 so the system doesn't roll to a newer minor on the next dnf upgrade:
```
echo '9.6' | sudo tee /etc/dnf/vars/releasever
sudo dnf clean all && sudo dnf makecache
```

Install and configure the Azure Managed Lustre repository for the DNF package manager. Create the following script and name it repo.bash:

#!/bin/bash
set -ex

rpm --import https://packages.microsoft.com/keys/microsoft.asc

DISTRIB_CODENAME=el9

REPO_PATH=/etc/yum.repos.d/amlfs.repo
echo -e "[amlfs]" > ${REPO_PATH}
echo -e "name=Azure Lustre Packages" >> ${REPO_PATH}
echo -e "baseurl=https://packages.microsoft.com/yumrepos/amlfs-${DISTRIB_CODENAME}" >> ${REPO_PATH}
echo -e "enabled=1" >> ${REPO_PATH}
echo -e "gpgcheck=1" >> ${REPO_PATH}
echo -e "gpgkey=https://packages.microsoft.com/keys/microsoft.asc" >> ${REPO_PATH}

Run the script as a superuser:
```
sudo bash repo.bash
```
Install the Lustre client package. Choose the install method that best fits your needs:
- Prebuilt kmod
- DKMS
The metapackage version doesn't always align with the kernel version. You can use the following command to install the proper metapackage:
```
sudo dnf install amlfs-lustre-client-2.15.8_34_gc0f2040-$(uname -r | sed -e "s/\.$(uname -p)$//" | sed -re 's/[-_]/\./g')-1
```
Note

Running dnf search amlfs-lustre-client doesn't show all available packages for your distribution. To see all available amlfs-lustre-client packages, run dnf list --showduplicates "amlfs-lustre-client*".

If you want to upgrade only the kernel and not all packages, you must (at minimum) also upgrade the amlfs-lustre-client metapackage so that the Lustre client can continue to work after the restart. The command should look similar to the following example:
```
export NEWKERNELVERSION=6.7.8
sudo dnf upgrade kernel-$NEWKERNELVERSION amlfs-lustre-client-2.15.8_34_gc0f2040-$(echo $NEWKERNELVERSION | sed -e "s/\.$(uname -p)$//" | sed -re 's/[-_]/\./g')-1
```
```
sudo dnf install -y lustre-client-dkms-2.15.8_35_gdf4872c
```
This DKMS package automatically includes the matching Lustre userspace tools package (lustre-client) as a dependency. So, a single dnf install command gives you both the module source and the userspace tools.

The DKMS package automatically compiles the Lustre kernel module for your running kernel. Unlike the prebuilt kmod package, you don't need to match a specific kernel version or use sed to transform the kernel version string. DKMS rebuilds the module automatically when your kernel is upgraded.

Note

DKMS requires kernel headers (kernel-devel), GCC, and Make to be installed. The package dependencies handle this requirement automatically, but the initial install takes a few minutes while the kernel module compiles.

Warning

We're no longer publishing new client packages for Ubuntu 18.04. Please migrate to one of the supported releases to run newer versions of the Azure Managed Lustre client packages.

Ubuntu 18.04 LTS reached the end of standard support on May 31, 2023. We recommend either migrating to the next Ubuntu LTS release or upgrading to Ubuntu Pro to gain access to extended security and maintenance from Canonical. For more information, see the announcement.

Ensure that you have Ubuntu Pro activated and are on the recommended 5.4 kernel, which the linux-image-azure metapackage provides:
```
apt list --installed linux-image*
```

Install and configure the Azure Managed Lustre repository for the APT package manager. Create the following script and name it repo.bash:

#!/bin/bash
set -ex

apt update && apt install -y ca-certificates curl apt-transport-https lsb-release gnupg
source /etc/lsb-release
echo "deb [arch=amd64] https://packages.microsoft.com/repos/amlfs-${DISTRIB_CODENAME}/ ${DISTRIB_CODENAME} main" | tee /etc/apt/sources.list.d/amlfs.list
curl -sL https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor | tee /etc/apt/trusted.gpg.d/microsoft.gpg > /dev/null

apt update

Run the script as a superuser:
```
sudo bash repo.bash
```
Install the metapackage that matches your running kernel.

The following command installs a metapackage that keeps the version of Lustre aligned with the installed kernel. For this alignment to work, you must use apt full-upgrade instead of apt upgrade when updating your system.
```
sudo apt install amlfs-lustre-client-2.15.4-42-gd6d405d=$(uname -r)
```
Note

Running apt search amlfs-lustre-client doesn't show all available packages for your distribution. To see all available amlfs-lustre-client packages, run apt list -a "amlfs-lustre-client*".

Optionally, if you want to upgrade only the kernel and not all packages, you must (at minimum) also upgrade the amlfs-lustre-client metapackage so that the Lustre client can continue to work after the restart. The command should look similar to the following example:
```
apt upgrade linux-image-[new kernel version] amlfs-lustre-client-2.15.4-42-gd6d405d
```

Install and configure the Azure Managed Lustre repository for the APT package manager. Create the following script and name it repo.bash:

#!/bin/bash
set -ex

apt update && apt install -y ca-certificates curl apt-transport-https lsb-release gnupg
source /etc/lsb-release
echo "deb [arch=amd64] https://packages.microsoft.com/repos/amlfs-${DISTRIB_CODENAME}/ ${DISTRIB_CODENAME} main" | tee /etc/apt/sources.list.d/amlfs.list
curl -sL https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor | tee /etc/apt/trusted.gpg.d/microsoft.gpg > /dev/null

apt update

Run the script as a superuser:
```
sudo bash repo.bash
```
Install the Lustre client package. Choose the install method that best fits your needs:
- Prebuilt kmod
- DKMS
The following command installs a metapackage that keeps the version of Lustre aligned with the installed kernel. For this alignment to work, you must use apt full-upgrade instead of apt upgrade when updating your system.
```
sudo apt install amlfs-lustre-client-2.15.8-34-gc0f2040=$(uname -r)
```
Note

Running apt search amlfs-lustre-client doesn't show all available packages for your distribution. To see all available amlfs-lustre-client packages, run apt list -a "amlfs-lustre-client*".

Optionally, if you want to upgrade only the kernel and not all packages, you must (at minimum) also upgrade the amlfs-lustre-client metapackage so that the Lustre client can continue to work after the restart. The command should look similar to the following example:
```
apt upgrade linux-image-[new kernel version] amlfs-lustre-client-2.15.8-34-gc0f2040
```
```
sudo apt install -y amlfs-lustre-client-dkms-2.15.8-35-gdf4872c
```
This metapackage installs the Lustre userspace tools (lustre-client) together with the DKMS module source package (lustre-client-modules-dkms), so they stay at matching versions.

The DKMS package automatically compiles the Lustre kernel module for your running kernel. Unlike the prebuilt kmod package, you don't need to match a specific kernel version - DKMS rebuilds the module automatically when your kernel is upgraded.

Note

DKMS requires kernel headers, GCC, and Make to be installed. The package dependencies handle this requirement automatically, but the initial install takes a few minutes while the kernel module compiles.

Important

The Azure Marketplace image for the Ubuntu 22.04 LTS release uses the Hardware Enablement (HWE) kernel by default. However, HWE kernels are supported only for six-month periods, and Lustre support for these kernels is often not available when they're released. We recommend that you switch to the LTS kernel because it gives you more stability and it maintains a kernel version that's supported with the Lustre client.

Install the LTS kernel metapackage:

sudo apt update && sudo apt install linux-image-azure-lts-22.04

Remove the default (HWE) kernel metapackage. The response to the following command also asks you to remove the linux-azure metapackage.
```
sudo apt remove linux-image-azure
```
List installed kernels and see which one the LTS metapackage supplies:
```
apt list --installed linux-image*
```
Newly provisioned hosts have two kernels, and older hosts might have more. Compare the version that the LTS metapackage provides against the other installed kernels.
Remove any kernels newer than the one mentioned in the LTS metapackage.
```
sudo apt remove linux-image-6.8.0-1027-azure
```
You receive a warning about removing the kernels, but these steps work if you're following them on a newly provisioned host. If you have concerns, consult Ubuntu documentation on configuring kernels to ensure that they can start after a restart.
List installed kernels again to verify that you don't have kernels newer than the one mentioned in the LTS metapackage:
```
apt list --installed linux-image*
```
Restart to load the LTS kernel.

Install and configure the Azure Managed Lustre repository for the APT package manager. Create the following script and name it repo.bash:

#!/bin/bash
set -ex

apt update && apt install -y ca-certificates curl apt-transport-https lsb-release gnupg
source /etc/lsb-release
echo "deb [arch=amd64] https://packages.microsoft.com/repos/amlfs-${DISTRIB_CODENAME}/ ${DISTRIB_CODENAME} main" | tee /etc/apt/sources.list.d/amlfs.list
curl -sL https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor | tee /etc/apt/trusted.gpg.d/microsoft.gpg > /dev/null

apt update

Run the script as a superuser:
```
sudo bash repo.bash
```
Install the Lustre client package. Choose the install method that best fits your needs:
- Prebuilt kmod
- DKMS
The following command installs a metapackage that keeps the version of Lustre aligned with the installed kernel. For this alignment to work, you must use apt full-upgrade instead of apt upgrade when updating your system.
```
sudo apt install amlfs-lustre-client-2.15.8-34-gc0f2040=$(uname -r)
```
Note

Running apt search amlfs-lustre-client doesn't show all available packages for your distribution. To see all available amlfs-lustre-client packages, run apt list -a "amlfs-lustre-client*".

Optionally, if you want to upgrade only the kernel and not all packages, you must (at minimum) also upgrade the amlfs-lustre-client metapackage so that the Lustre client can continue to work after the restart. The command should look similar to the following example:
```
apt upgrade linux-image-[new kernel version] amlfs-lustre-client-2.15.8-34-gc0f2040
```
```
sudo apt install -y amlfs-lustre-client-dkms-2.15.8-35-gdf4872c
```
This metapackage installs the Lustre userspace tools (lustre-client) together with the DKMS module source package (lustre-client-modules-dkms), so they stay at matching versions.

The DKMS package automatically compiles the Lustre kernel module for your running kernel. Unlike the prebuilt kmod package, you don't need to match a specific kernel version - DKMS rebuilds the module automatically when your kernel is upgraded.

Note

DKMS requires kernel headers, GCC, and Make to be installed. The package dependencies handle this requirement automatically, but the initial install takes a few minutes while the kernel module compiles.

Important

The Azure Marketplace image for the Ubuntu 24.04 LTS release uses the Hardware Enablement (HWE) kernel by default. However, HWE kernels are supported only for six-month periods, and Lustre support for these kernels is often not available when they're released. We recommend that you switch to the LTS kernel because it gives you more stability and it maintains a kernel version that's supported with the Lustre client.

Install the LTS kernel metapackage:

sudo apt update && sudo apt install linux-image-azure-lts-24.04

Remove the default (HWE) kernel metapackage. The response to the following command also asks you to remove the linux-azure metapackage.
```
sudo apt remove linux-image-azure
```
List installed kernels and see which one the LTS metapackage supplies:
```
apt list --installed linux-image*
```
Newly provisioned hosts have two kernels, and older hosts might have more. Compare the version that the LTS metapackage provides against the other installed kernels.
Remove any kernels newer than the one mentioned in the LTS metapackage.
```
sudo apt remove linux-image-6.11.0-1013-azure
```
You receive a warning about removing the kernels, but these steps work if you're following them on a newly provisioned host. If you have concerns, consult Ubuntu documentation on configuring kernels to ensure that they can start after a restart.
List installed kernels again to verify that you don't have kernels newer than the one mentioned in the LTS metapackage:
```
apt list --installed linux-image*
```
Restart to load the LTS kernel.

Install and configure the Azure Managed Lustre repository for the APT package manager. Create the following script and name it repo.bash:

 #!/bin/bash
 set -ex

 apt update && apt install -y ca-certificates curl apt-transport-https lsb-release gnupg dpkg-dev
 source /etc/lsb-release
 ARCH=$(dpkg-architecture -q DEB_BUILD_ARCH)
 echo "deb [arch=${ARCH}] https://packages.microsoft.com/repos/amlfs-${DISTRIB_CODENAME}/ ${DISTRIB_CODENAME} main" | tee /etc/apt/sources.list.d/amlfs.list
 curl -sL https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor | tee /etc/apt/trusted.gpg.d/microsoft.gpg > /dev/null

 apt update

Run the script as a superuser:
```
sudo bash repo.bash
```
Install the Lustre client package. Choose the install method that best fits your needs:
- Prebuilt kmod
- DKMS
The following command installs a metapackage that keeps the version of Lustre aligned with the installed kernel. For this alignment to work, you must use apt full-upgrade instead of apt upgrade when updating your system.

Note

2.16 is a non-LTS release of Lustre and will stop receiving support from the community soon after the release of 2.17. Please check back in late 2025/early 2026 for more information about the 2.17 release.
```
sudo apt install amlfs-lustre-client-2.16.1-14-gbc76088=$(uname -r)
```
Note

Running apt search amlfs-lustre-client doesn't show all available packages for your distribution. To see all available amlfs-lustre-client packages, run apt list -a "amlfs-lustre-client*".

Optionally, if you want to upgrade only the kernel and not all packages, you must (at minimum) also upgrade the amlfs-lustre-client metapackage so that the Lustre client can continue to work after the restart. The command should look similar to the following example:
```
apt upgrade linux-image-[new kernel version] amlfs-lustre-client-2.16.1-14-gbc76088
```
Note

2.16 is a non-LTS release of Lustre. Community support ends soon after the 2.17 release.
```
sudo apt install -y amlfs-lustre-client-dkms-2.16.1-22-g584eedc
```
This metapackage installs the Lustre userspace tools (lustre-client) together with the DKMS module source package (lustre-client-modules-dkms), so they stay at matching versions.

The DKMS package automatically compiles the Lustre kernel module for your running kernel. Unlike the prebuilt kmod package, you don't need to match a specific kernel version. DKMS rebuilds the module automatically when your kernel is upgraded.

Note

DKMS requires kernel headers, GCC, and Make to be installed. The package dependencies handle this requirement automatically, but the initial install takes a few minutes while the kernel module compiles.

Important

Azure Linux 3 requires kernel version 6.6.119.3 or newer. Check your kernel version with uname -r. If you need to upgrade your kernel, run sudo tdnf upgrade kernel and reboot before installing the Lustre client.

Install and configure the Azure Managed Lustre repository for the TDNF package manager. Create the following script and name it repo.bash:

#!/bin/bash
set -ex

rpm --import https://packages.microsoft.com/keys/microsoft.asc

DISTRIB_CODENAME=al3

REPO_PATH=/etc/yum.repos.d/amlfs.repo
echo -e "[amlfs]" > ${REPO_PATH}
echo -e "name=Azure Lustre Packages" >> ${REPO_PATH}
echo -e "baseurl=https://packages.microsoft.com/yumrepos/amlfs-${DISTRIB_CODENAME}" >> ${REPO_PATH}
echo -e "enabled=1" >> ${REPO_PATH}
echo -e "gpgcheck=1" >> ${REPO_PATH}
echo -e "gpgkey=https://packages.microsoft.com/keys/microsoft.asc" >> ${REPO_PATH}

Run the script as a superuser:
```
sudo bash repo.bash
```
Install the Lustre client package. Choose the install method that best fits your needs:
- Prebuilt kmod
- DKMS
The metapackage version doesn't always align with the kernel version. You can use the following command to install the proper metapackage:
```
sudo tdnf install -y amlfs-lustre-client-2.16.1_21_g153e389-$(uname -r | sed -e "s/\.$(uname -p)$//" | sed -re 's/[-_]/\./g')-1
```
Note

Running tdnf search amlfs-lustre-client doesn't show all available packages for your distribution. To see all available amlfs-lustre-client packages, run tdnf list "amlfs-lustre-client*".

If you want to upgrade the kernel, you must first remove the existing Lustre packages, upgrade the kernel, set the new kernel as default, reboot, and then install the Lustre client for the new kernel:
```
# Remove existing Lustre packages
sudo lustre_rmmod
sudo tdnf remove '*lustre*' -y

# Upgrade kernel
sudo tdnf upgrade kernel -y

# Set newest kernel as default and reboot
sudo sed -i 's/^GRUB_DEFAULT=.*/GRUB_DEFAULT=0/' /etc/default/grub
sudo grub2-mkconfig -o /boot/grub2/grub.cfg
sudo reboot
```
After the reboot, install the Lustre client for your new kernel:
```
sudo tdnf install -y amlfs-lustre-client-2.16.1_21_g153e389-$(uname -r | sed -e "s/\.$(uname -p)$//" | sed -re 's/[-_]/\./g')-1
```
```
sudo tdnf install -y lustre-client-dkms-2.16.1_22_g584eedc
```
This DKMS package automatically includes the matching Lustre userspace tools package (lustre-client) as a dependency. So, a single tdnf install command gives you both the module source and the userspace tools.

The DKMS package automatically compiles the Lustre kernel module for your running kernel. Unlike the prebuilt kmod package, you don't need to match a specific kernel version or use sed to transform the kernel version string. DKMS rebuilds the module automatically when your kernel is upgraded.

Note

DKMS requires kernel headers (kernel-headers and kernel-devel), GCC, and Make to be installed. The package dependencies handle this requirement automatically, but the initial install takes a few minutes while the kernel module compiles.

Feedback

Was this page helpful?

Last updated on 2026-06-11

Install Lustre client software

Upgrade client software for AlmaLinux HPC 8.6

Install client software for Red Hat Enterprise Linux 7

Install client software for Red Hat Enterprise Linux 8 or AlmaLinux 8

Install client software for Red Hat Enterprise Linux 9 or AlmaLinux 9

Install client software for Ubuntu 18.04

Install client software for Ubuntu 20.04

Install client software for Ubuntu 22.04

Install client software for Ubuntu 24.04

Install client software for Azure Linux 3

Download and install client software

Related content

Feedback

Additional resources