Linux Software Repository for Microsoft Products

• 10/16/2017
• 2 minutes to read
• • 
  • 
  • 
  • 
  • 
  • +2

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.

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)

   curl https://packages.microsoft.com/keys/microsoft.asc | sudo apt-key add -
   sudo apt-add-repository https://packages.microsoft.com/ubuntu/14.04/prod
   sudo apt-get update
  

• Ubuntu 16.04 (Xenial)

   curl https://packages.microsoft.com/keys/microsoft.asc | sudo apt-key add -
   sudo apt-add-repository https://packages.microsoft.com/ubuntu/16.04/prod
   sudo apt-get update
  

• Ubuntu 18.04 (Bionic)

   curl https://packages.microsoft.com/keys/microsoft.asc | sudo apt-key add -
   sudo apt-add-repository https://packages.microsoft.com/ubuntu/18.04/prod
   sudo apt-get update
  

• Ubuntu 18.10 (Cosmic)

   curl https://packages.microsoft.com/keys/microsoft.asc | sudo apt-key add -
   sudo apt-add-repository https://packages.microsoft.com/ubuntu/18.10/prod
   sudo apt-get update
  

• Ubuntu 19.04 (Disco)

   curl https://packages.microsoft.com/keys/microsoft.asc | sudo apt-key add -
   sudo apt-add-repository https://packages.microsoft.com/ubuntu/19.04/prod
   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/