Linux Software Repository for Microsoft Products

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 http://packages.microsoft.com/config/rhel/6/packages-microsoft-prod.rpm
    
  • Enterprise Linux 7 (EL7)

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

Ubuntu

  • Ubuntu 14.04 (Trusty)

     wget http://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 http://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 http://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 http://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

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/