Installation guidance for SQL Server on Linux
This topic explains how to install, update, and uninstall SQL Server 2017 on Linux. SQL Server 2017 is supported on Red Hat Enterprise Linux (RHEL), SUSE Linux Enterprise Server (SLES), and Ubuntu. It is also available as a Docker image, which can run on Docker Engine on Linux or Docker for Windows/Mac.
SQL Server 2017 is supported on the following Linux platforms:
|Red Hat Enterprise Linux||7.3 or 7.4||Get RHEL 7.4|
|SUSE Linux Enterprise Server||v12 SP2||Get SLES v12 SP2|
|Ubuntu||16.04||Get Ubuntu 16.04|
|Docker Engine||1.8+||Get Docker|
SQL Server 2017 has the following system requirements for Linux:
|File System||XFS or EXT4 (other file systems, such as BTRFS, are unsupported)|
|Disk space||6 GB|
|Processor speed||2 GHz|
|Processor cores||2 cores|
|Processor type||x64-compatible only|
If you use Network File System (NFS) remote shares in production, note the following support requirements:
- Use NFS version 4.2 or higher. Older versions of NFS do not support required features, such as fallocate and sparse file creation, common to modern file systems.
- Locate only the /var/opt/mssql directories on the NFS mount. Other files, such as the SQL Server system binaries, are not supported.
- Ensure that NFS clients use the 'nolock' option when mounting the remote share.
Install SQL Server
You can install SQL Server on Linux from the command line. For instructions, see one of the following quick start tutorials:
- Install on Red Hat Enterprise Linux
- Install on SUSE Linux Enterprise Server
- Install on Ubuntu
- Run on Docker
- Provision a SQL VM in Azure
Update SQL Server
To update the mssql-server package to the latest release, use one of the following commands based on your platform:
|Platform||Package update command(s)|
These commands download the newest package and replace the binaries located under
/opt/mssql/. The user generated databases and system databases are not affected by this operation.
Rollback SQL Server
To rollback or downgrade SQL Server to a previous release, use the following steps:
Identify the version number for the SQL Server package you want to downgrade to. For a list of package numbers, see the Release notes.
Downgrade to a previous version of SQL Server. In the following commands, replace
<version_number>with the SQL Server version number you identified in step one.
Platform Package update command(s) RHEL
sudo yum downgrade mssql-server-<version_number>.x86_64
sudo zypper install --oldpackage mssql-server=<version_number>
sudo apt-get install mssql-server=<version_number>
sudo systemctl start mssql-server
It is only supported to downgrade to a release within the same major version, such as SQL Server 2017.
Check installed SQL Server version
To verify your current version and edition of SQL Server on Linux, use the following procedure:
If not already installed, install the SQL Server command-line tools.
Use sqlcmd to run a Transact-SQL command that displays your SQL Server version and edition.
sqlcmd -S localhost -U SA -Q 'select @@VERSION'
Uninstall SQL Server
To remove the mssql-server package on Linux, use one of the following commands based on your platform:
|Platform||Package removal command(s)|
Removing the package does not delete the generated database files. If you want to delete the database files, use the following command:
sudo rm -rf /var/opt/mssql/
Configure source repositories
When you install or upgrade SQL Server, you get the latest version of SQL Server from your configured Microsoft repository.
There are two main types of repositories for each distribution:
Cumulative Updates (CU): The Cumulative Update (CU) repository contains packages for the base SQL Server release and any bug fixes or improvements since that release. Cumulative updates are specific to a release version, such as SQL Server 2017. They are released on a regular cadence.
GDR: The GDR repository contains packages for the base SQL Server release and only critical fixes and security updates since that release. These updates are also added to the next CU release.
Each CU and GDR release contains the full SQL Server package and all previous updates for that repository. Updating from a GDR release to a CU release is supported by changing your configured repository for SQL Server. You can also downgrade to any release within your major version (ex: 2017). Updating from a CU release to a GDR release is not supported.
Check your configured repository
If you want to verify what repository is configured, use the following platform-dependent techniques.
|RHEL||1. View the files in the /etc/yum.repos.d directory:
2. Look for a file that configures the SQL Server directory, such as mssql-server.repo.
3. Print out the contents of the file:
4. The name property is the configured repository.
|SLES||1. Run the following command:
2. The Repository property is the configured repository.
|Ubuntu||1. Run the following command:
2. Examine the package URL for mssql-server.
The end of the repository URL confirms the repository type:
- mssql-server: preview repository.
- mssql-server-2017: CU repository.
- mssql-server-2017-gdr: GDR repository.
Change the source repository
To configure the CU or GDR repositories, use the following steps:
The quick start tutorials configure the CU repository. If you follow those tutorials, you do not need to use the steps below to continue using the CU repository. These steps are only necessary for changing your configured repository.
If necessary, remove the previously configured repository.
Platform Repository Repository removal command RHEL All
sudo rm -rf /etc/yum.repos.d/mssql-server.repo
sudo zypper removerepo 'packages-microsoft-com-mssql-server'
sudo zypper removerepo 'packages-microsoft-com-mssql-server-2017'
sudo zypper removerepo 'packages-microsoft-com-mssql-server-2017-gdr'
sudo add-apt-repository -r 'deb [arch=amd64] https://packages.microsoft.com/ubuntu/16.04/mssql-server xenial main'
sudo add-apt-repository -r 'deb [arch=amd64] https://packages.microsoft.com/ubuntu/16.04/mssql-server-2017 xenial main'
sudo add-apt-repository -r 'deb [arch=amd64] https://packages.microsoft.com/ubuntu/16.04/mssql-server-2017-gdr xenial main'
For Ubuntu only, import the public repository GPG keys.
sudo curl https://packages.microsoft.com/keys/microsoft.asc | sudo apt-key add -
Configure the new repository.
Platform Repository Command RHEL CU
sudo curl -o /etc/yum.repos.d/mssql-server.repo https://packages.microsoft.com/config/rhel/7/mssql-server-2017.repo
sudo curl -o /etc/yum.repos.d/mssql-server.repo https://packages.microsoft.com/config/rhel/7/mssql-server-2017-gdr.repo
sudo zypper addrepo -fc https://packages.microsoft.com/config/sles/12/mssql-server-2017.repo
sudo zypper addrepo -fc https://packages.microsoft.com/config/sles/12/mssql-server-2017-gdr.repo
sudo add-apt-repository "$(curl https://packages.microsoft.com/config/ubuntu/16.04/mssql-server-2017.list)" && sudo apt-get update
sudo add-apt-repository "$(curl https://packages.microsoft.com/config/ubuntu/16.04/mssql-server-2017-gdr.list)" && sudo apt-get update
At this point, if you choose to use one of the installation tutorials, such as the quickstart tutorials, remember that you have just configured the target repository. Do not repeat that step in the tutorials. This is especially true if you configure the GDR repository, because the quickstart tutorials use the CU repository.
You can perform an unattended installation in the following way:
- Follow the initial steps in the quick start tutorials to register the repositories and install SQL Server.
- When you run
mssql-conf setup, set environment variables and use the
-n(no prompt) option.
The following example configures the Developer edition of SQL Server with the MSSQL_PID environment variable. It also accepts the EULA (ACCEPT_EULA) and sets the SA user password (MSSQL_SA_PASSWORD). The
-n parameter performs an unprompted installation where the configuration values are pulled from the environment variables.
sudo MSSQL_PID=Developer ACCEPT_EULA=Y MSSQL_SA_PASSWORD='<YourStrong!Passw0rd>' /opt/mssql/bin/mssql-conf -n setup
You can also create a script that performs other actions. For example, you could install other SQL Server packages.
For a more detailed sample script, see the following examples:
- Red Hat unattended installation script
- SUSE unattended installation script
- Ubuntu unattended installation script
If your Linux machine does not have access to the online repositories used in the quick starts, you can download the package files directly. These packages are located in the Microsoft repository, https://packages.microsoft.com.
If you successfully installed with the steps in the quick starts, you do not need to download or manually install the package(s) below. This section is only for the offline scenario.
Download the database engine package for your platform. Find package download links in the package details section of the Release Notes.
Move the downloaded package to your Linux machine. If you used a different machine to download the packages, one way to move the packages to your Linux machine is with the scp command.
Install the database engine package. Use one of the following commands based on your platform. Replace the package file name in this example with the exact name you downloaded.
Platform Package removal command RHEL
sudo yum localinstall mssql-server_versionnumber.x86_64.rpm
sudo zypper install mssql-server_versionnumber.x86_64.rpm
sudo dpkg -i mssql-server_versionnumber_amd64.deb
You can also install the RPM packages (RHEL and SLES) with the
rpm -ivhcommand, but the commands in the previous table automatically install dependencies if available from approved repositories.
Resolve missing dependencies: You might have missing dependencies at this point. If not, you can skip this step. On Ubuntu, if you have access to approved repositories containing those dependencies, the easiest solution is to use the
apt-get -f installcommand. This command also completes the installation of SQL Server. To manually inspect dependencies, use the following commands:
Platform List dependencies command RHEL
rpm -qpR mssql-server_versionnumber.x86_64.rpm
rpm -qpR mssql-server_versionnumber.x86_64.rpm
dpkg -I mssql-server_versionnumber_amd64.deb
After resolving the missing dependencies, attempt to install the mssql-server package again.
Complete the SQL Server setup. Use mssql-conf to complete the SQL Server setup:
sudo /opt/mssql/bin/mssql-conf setup
After installation, you can also install other optional SQL Server packages.
- SQL Server command-line tools
- SQL Server Agent
- SQL Server Full Text Search
- SQL Server Integration Services (Ubuntu)
Connect to your SQL Server instance to begin creating and managing databases. To get started, see the quick start tutorials: