Linux Software Repository for Microsoft Products

Microsoft builds and supports a variety of software products for Linux systems and makes them available via Linux packaging clients (apt, dnf, yum, etc). These Linux software packages are hosted on the "Linux software repository for Microsoft products": https://packages.microsoft.com. You can file issues or pull requests on the affiliated GitHub repo: Microsoft Linux Package Repositories.

This page offers guidance on how to download and install the "Linux software repository for Microsoft products" (https://packages.microsoft.com) to your Linux system, so you can then install and upgrade Microsoft software that is built for Linux using your distribution's standard package management tools.

How to install Microsoft software packages using the Linux Repository

The Linux Software Repository can be configured to automatically install the Linux package that applies to your Linux distribution and version. Each Microsoft product may require a slightly different installation process. The package install includes the repository configuration, along with the GPG public key used to validate the signed packages and/or repository metadata.

Note

Optionally, if you prefer manual configuration, the Linux Software Repository configuration files are available at https://packages.microsoft.com/config. The name and location of these files can be located using the following URI naming convention: https://packages.microsoft.com/config/<Distribution>/<Version>/prod.(repo|list)

Examples of available Microsoft products in the Linux Repository

The following Microsoft products are a few examples that offer Linux versions supported for install using the Linux Repository (package.microsoft.com). See the associated documentation link for more specific installation steps.

Important

Packages in the Linux Software Repository are subject to the license terms located in each package. Please read the license terms prior to using the package. Your installation and use of the package constitutes your acceptance of these terms. If you do not agree with the license terms, do not use the package.

How to use the GPG Repository Signing Key

Linux Software Repository for Microsoft Products uses the GPG (GNU Privacy Guard) enabling users to verify the authenticity of files and to check the signatures of downloaded packages.

  • Microsoft's GPG public key may be downloaded here: https://packages.microsoft.com/keys/microsoft.asc
  • Public Key ID: Microsoft (Release signing) gpgsecurity@microsoft.com
  • Public Key Fingerprint: BC52 8686 B50D 79E3 39D3 721C EB3E 94AD BE12 29CF

Command examples for using the Linux repository service

  • Install a repository configuration: curl -sSL https://packages.microsoft.com/config/<distribution>/<version>/prod.list | sudo tee /etc/apt/sources.list.d/microsoft-prod.list (replacing <distribution> and <version> with the name of the supported Linux distribution and version you wish to use). If you're unsure what distribution and version you are currently running, you can try entering lsb_release -a (for any distro that includes the “lsb-release" package) or cat /etc/os-release (for any distro that uses systemd).

  • Download the Microsoft repository GPG public key: curl -sSL https://packages.microsoft.com/keys/microsoft.asc | sudo tee /etc/apt/trusted.gpg.d/microsoft.asc

  • Register the Microsoft repository GPG public key: sudo dpkg -i packages-microsoft-prod.deb

  • Delete the the Microsoft repository GPG public keys file after registering: rm packages-microsoft-prod.deb

  • Update package index files: sudo <apt-get> update (replacing <apt-get> with the appropriate command for the package manager used with your Linux distribution).

  • To install the Microsoft product package you're after using this Linux repository (packages.microsoft.com): sudo <apt-get> install <product-name> (replacing <apt-get> with the appropriate command for the package manager used with your Linux distribution and <product-name> with the name of the Microsoft software that you want to install).

See packages.microsoft.com find the list of supported Linux distributions and versions.

How to file an issue, request a feature, or report a security vulnerability

We want to ensure that our Linux customers are well-supported. The following communication channels are available to users of the PMC service:

  • Report an issue: Help us improve the PMC service by reporting any issues you are experiencing.

  • Request a feature: Request a new feature or enhancement to the PMC service.

  • Report a security vulnerability: Help us to identify any potential security vulnerabilities by reviewing our security policy and reporting any issues.