Linux Software Repository for Microsoft Products

10/16/2017
2 minutes to read
Contributors

Overview

Microsoft builds and supports a variety of software products for Linux systems and makes them available via standard APT and YUM package repositories. This document describes how to configure the repository on your Linux system, so that you can then install/upgrade Microsoft's Linux software using your distribution's standard package management tools.

Microsoft’s Linux Software Repository is comprised of multiple sub-repositories:

prod – The Production sub-repository is designated for packages intended for use in production. These packages are commercially supported by Microsoft under the terms of the applicable support agreement or program that you have with Microsoft.
mssql-server - These repositories contain packages for Microsoft SQL Server on Linux - See also: SQL Server on Linux.

Note

Packages in the Linux software repositories are subject to the license terms located in the packages. 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.

Configuring the repositories

Repositories can be configured automatically by installing the Linux package that applies to your Linux distribution and version. The package will install the repository configuration along with the GPG public key used by tools such as apt/yum/zypper to validate the signed packages and/or repository metadata.

Enterprise Linux (RHEL and variants)

Enterprise Linux 6 (EL6)

 sudo rpm -Uvh https://packages.microsoft.com/config/rhel/6/packages-microsoft-prod.rpm

Enterprise Linux 7 (EL7)

 sudo rpm -Uvh https://packages.microsoft.com/config/rhel/7/packages-microsoft-prod.rpm

Ubuntu

Ubuntu 14.04 (Trusty)

 wget https://packages.microsoft.com/config/ubuntu/14.04/packages-microsoft-prod.deb
 sudo dpkg -i packages-microsoft-prod.deb
 sudo apt-get update

Ubuntu 16.04 (Xenial)

 wget https://packages.microsoft.com/config/ubuntu/16.04/packages-microsoft-prod.deb
 sudo dpkg -i packages-microsoft-prod.deb
 sudo apt-get update

Ubuntu 16.10 (Yakkety)

 wget https://packages.microsoft.com/config/ubuntu/16.10/packages-microsoft-prod.deb
 sudo dpkg -i packages-microsoft-prod.deb
 sudo apt-get update

SUSE Linux Enterprise 12

    sudo rpm -Uvh https://packages.microsoft.com/config/sles/12/packages-microsoft-prod.rpm

Manual Configuration

The repository configuration files are available from 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)

Package and Repository Signing Key

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

Examples:

RHEL/CentOS 7

 # Install repository configuration
 curl https://packages.microsoft.com/config/rhel/7/prod.repo > ./microsoft-prod.repo
 sudo cp ./microsoft-prod.repo /etc/yum.repos.d/

 # Install Microsoft's GPG public key
 curl https://packages.microsoft.com/keys/microsoft.asc > ./microsoft.asc
 sudo rpm --import ./microsoft.asc

Ubuntu 16.04

 # Install repository configuration
 curl https://packages.microsoft.com/config/ubuntu/16.04/prod.list > ./microsoft-prod.list
 sudo cp ./microsoft-prod.list /etc/apt/sources.list.d/

 # Install Microsoft GPG public key
 curl https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.gpg
 sudo cp ./microsoft.gpg /etc/apt/trusted.gpg.d/