Skip to content

Commit 9858354

Browse files
authored
Refresh SQL Server on Linux overview (#36698)
1 parent 7430bf5 commit 9858354

6 files changed

Lines changed: 66 additions & 41 deletions

File tree

.openpublishing.redirection.json

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -67440,6 +67440,11 @@
6744067440
"redirect_url": "/sql/linux/tutorial-sql-server-containers-kubernetes-dh2i",
6744167441
"redirect_document_id": false
6744267442
},
67443+
{
67444+
"source_path": "docs/linux/sql-server-linux-whats-new.md",
67445+
"redirect_url": "/sql/linux/sql-server-linux-whats-new-2017",
67446+
"redirect_document_id": false
67447+
},
6744367448
{
6744467449
"source_path": "docs/relational-databases/system-tables/msrepl-agent-jobs.md",
6744567450
"redirect_url": "/sql/relational-databases/system-tables/msrepl-agent-jobs-transact-sql",

docs/includes/business-continuity/business-continuity.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ Everyone who deploys [!INCLUDE [ssnoversion-md](../ssnoversion-md.md)] needs to
1919
| What's new in [!INCLUDE [sssql25-md](../sssql25-md.md)] | [Windows](../../sql-server/what-s-new-in-sql-server-2025.md) | [Linux](../../linux/sql-server-linux-whats-new-2025.md) |
2020
| What's new in [!INCLUDE [sssql22-md](../sssql22-md.md)] | [Windows](../../sql-server/what-s-new-in-sql-server-2022.md) | [Linux](../../linux/sql-server-linux-whats-new-2022.md) |
2121
| What's new in [!INCLUDE [sssql19-md](../sssql19-md.md)] | [Windows](../../sql-server/what-s-new-in-sql-server-2019.md) | [Linux](../../linux/sql-server-linux-whats-new-2019.md) |
22-
| What's new in [!INCLUDE [sssql17-md](../sssql17-md.md)] | [Windows](../../sql-server/what-s-new-in-sql-server-2017.md) | [Linux](../../linux/sql-server-linux-whats-new.md) |
22+
| What's new in [!INCLUDE [sssql17-md](../sssql17-md.md)] | [Windows](../../sql-server/what-s-new-in-sql-server-2017.md) | [Linux](../../linux/sql-server-linux-whats-new-2017.md) |
2323

2424
This article focuses on the availability scenarios in [!INCLUDE [sssql17-md](../sssql17-md.md)] and later versions, as well as the new and enhanced availability features. The scenarios include hybrid ones that can span [!INCLUDE [ssnoversion-md](../ssnoversion-md.md)] deployments on both Windows Server and Linux, and ones that can increase the number of readable copies of a database.
2525

docs/linux/sql-server-linux-overview.md

Lines changed: 58 additions & 38 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,8 @@ title: Overview of SQL Server on Linux
33
description: This article describes how SQL Server runs on Linux and provides information on how to learn more.
44
author: rwestMSFT
55
ms.author: randolphwest
6-
ms.date: 01/02/2026
6+
ms.reviewer: amitkh, atsingh
7+
ms.date: 02/24/2026
78
ms.service: sql
89
ms.subservice: linux
910
ms.topic: concept-article
@@ -15,65 +16,84 @@ ms.custom:
1516

1617
[!INCLUDE [SQL Server - Linux](../includes/applies-to-version/sql-linux.md)]
1718

18-
[!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] runs on Linux, starting with [!INCLUDE [sssql17-md](../includes/sssql17-md.md)]. It's the same [!INCLUDE [ssdenoversion-md](../includes/ssdenoversion-md.md)], with many similar features and services regardless of your operating system.
19+
[!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] runs on Linux, starting with [!INCLUDE [sssql17-md](../includes/sssql17-md.md)]. It's the same [!INCLUDE [ssdenoversion-md](../includes/ssdenoversion-md.md)] with many similar features and services across supported operating systems.
1920

20-
## Install
21+
## Get started
2122

22-
To get started, install [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] on Linux using one of the following quickstarts:
23+
If you're familiar with [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] and unfamiliar with Linux, see [New to Linux resources for SQL users](new-to-linux-resources.md).
2324

24-
- [Quickstart: Install SQL Server and create a database on Red Hat Enterprise Linux](quickstart-install-connect-red-hat.md)
25-
- [Quickstart: Install SQL Server and create a database on SUSE Linux Enterprise Server](quickstart-install-connect-suse.md)
26-
- [Quickstart: Install SQL Server and create a database on Ubuntu](quickstart-install-connect-ubuntu.md)
27-
- [Quickstart: Run SQL Server Linux container images with Docker](quickstart-install-connect-docker.md)
28-
- [Provision a SQL VM in Azure](/azure/azure-sql/virtual-machines/linux/sql-vm-create-portal-quickstart?toc=/sql/toc/toc.json)
25+
If you're familiar with Linux and unfamiliar with [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)], see [New to SQL Server: Learning resources](new-to-sql-learning-resources.yml).
2926

30-
> [!NOTE]
31-
> Starting in [!INCLUDE [sssql25-md](../includes/sssql25-md.md)], SUSE Linux Enterprise Server (SLES) isn't supported.
27+
## Choose your installation
28+
29+
The following sections help you install [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] on Linux in your preferred environment.
30+
31+
- Install SQL Server directly on a **[Linux machine or VM](#linux-vm)**
32+
- Run SQL Server in a **[Linux container](#container-images)**
33+
- Install SQL Server on **[Windows Subsystem for Linux (WSL 2)](#wsl2)** *(for development only)*
34+
35+
<a id="linux-vm"></a>
36+
37+
### Install SQL Server directly on a Linux machine or VM
38+
39+
The following quickstart articles describe how to install SQL Server on Linux on physical hardware or a virtual machine (VM) and create a database:
40+
41+
| Platform | SQL Server version supported |
42+
| --- | --- |
43+
| [Red Hat Enterprise Linux](quickstart-install-connect-red-hat.md) (RHEL) | 2017, 2019, 2022, and 2025 |
44+
| [Ubuntu](quickstart-install-connect-ubuntu.md) | 2017, 2019, 2022, and 2025 |
45+
| [SUSE Linux Enterprise Server](quickstart-install-connect-suse.md) (SLES) <sup>1</sup> | 2017, 2019, and 2022 only |
46+
| [SQL Server on Azure Virtual Machines](/azure/azure-sql/virtual-machines/linux/sql-vm-create-portal-quickstart?toc=/sql/toc/toc.json) | 2017, 2019, 2022, and 2025 |
47+
48+
<sup>1</sup> SUSE Linux Enterprise Server (SLES) isn't supported on [!INCLUDE [sssql25-md](../includes/sssql25-md.md)] and later versions.
49+
50+
<a id="container-images"></a>
3251

33-
### Container images
52+
### Run SQL Server in a Linux container
3453

35-
The [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] container images are published and available on the Microsoft Container Registry (MCR), and also cataloged at the following locations, based on the operating system image that was used when creating the container image:
54+
Containers are useful in local testing, continuous integration and deployment (CI/CD), and ephemeral workloads in your development environment. They're also commonly used as part of container orchestration in production environments, including Azure Kubernetes Services (AKS), Red Hat OpenShift, and DH2i DxOperator.
55+
56+
For instructions on how to install SQL Server in a Linux container, see [Quickstart: Run SQL Server Linux container images with Docker](quickstart-install-connect-docker.md).
57+
58+
The [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] container images are published and available on the Microsoft Container Registry (MCR). They're also cataloged at the following locations, based on the operating system image that was used when creating the container image:
3659

3760
- For both RHEL and Ubuntu based [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] container images, see [SQL Server on the Microsoft Artifact Registry](https://mcr.microsoft.com/catalog?cat=Databases).
3861
- For RHEL-based [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] container images, see [SQL Server Red Hat containers](https://catalog.redhat.com/software/containers/mssql/rhel/server/61f2f612f385723914ed60bc).
3962

4063
> [!NOTE]
41-
> Containers will only be published to MCR for the *most recent* Linux distributions. If you create your own custom [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] container image for an older supported distribution, it will still be supported. For more information, see [Upcoming updates to SQL Server container images on Microsoft Artifact Registry aka (MCR)](https://techcommunity.microsoft.com/blog/sqlserver/upcoming-updates-to-sql-server-container-images-on-microsoft-artifact-registry-a/3573013).
64+
> Containers are only published to MCR for the *most recent* Linux distributions. If you create your own custom [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] container image for an older supported distribution, it's still supported. For more information, see [Upcoming updates to SQL Server container images on Microsoft Artifact Registry (MCR)](https://techcommunity.microsoft.com/blog/sqlserver/upcoming-updates-to-sql-server-container-images-on-microsoft-artifact-registry-a/3573013).
4265
43-
## Connect
66+
<a id="wsl2"></a>
4467

45-
After installation, connect to the [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] instance on your Linux machine. You can connect locally or remotely and with various tools and drivers. The quickstarts demonstrate how to use the [sqlcmd](sql-server-linux-setup-tools.md) command-line tool. Other tools include the following:
68+
### Install SQL Server on Windows Subsystem for Linux (WSL 2)
4669

47-
| Tool | Tutorial |
48-
| --- | --- |
49-
| Visual Studio Code (VS Code) | [SQL Server extension for Visual Studio Code](../tools/visual-studio-code-extensions/mssql/connect-database-visual-studio-code.md) |
50-
| SQL Server Management Studio (SSMS) | [Use SQL Server Management Studio on Windows to manage SQL Server on Linux](sql-server-linux-manage-ssms.md) |
51-
| SQL Server Data Tools (SSDT) | [Use Visual Studio to create databases for SQL Server on Linux](sql-server-linux-develop-use-ssdt.md) |
70+
SQL Server on WSL 2 is intended for development purposes only, and is **not** supported for production workloads. Run SQL Server in WSL environments on one of the [supported platforms](sql-server-linux-release-notes-2025.md#supported-platforms) for the version of SQL Server you intend to run.
5271

53-
## Explore
72+
For instructions on how to install SQL Server on WSL 2, see [Windows Subsystem for Linux (WSL 2)](quickstart-install-connect-wsl-2.md).
5473

55-
Starting with [!INCLUDE [sssql17-md](../includes/sssql17-md.md)], [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] has the same underlying [!INCLUDE [ssde-md](../includes/ssde-md.md)] on all supported platforms, including Linux and containers. Therefore, many existing features and capabilities operate the same way. This area of the documentation exposes some of these features from a Linux perspective. It also calls out areas that have unique requirements on Linux.
74+
## Connect
5675

57-
If you're already familiar with [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] on Linux, review the release notes for general guidelines and known issues for this release:
76+
After installation, connect to the [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] instance on your Linux machine. You can connect locally or remotely and with various tools and drivers. The quickstarts demonstrate how to use the [sqlcmd](sql-server-linux-setup-tools.md) command-line tool. Other tools include:
5877

59-
- [Release notes for SQL Server 2025 on Linux](sql-server-linux-release-notes-2025.md)
60-
- [Release notes for SQL Server 2022 on Linux](sql-server-linux-release-notes-2022.md)
61-
- [Release notes for SQL Server 2019 on Linux](sql-server-linux-release-notes-2019.md)
62-
- [Release notes for SQL Server 2017 on Linux](sql-server-linux-release-notes-2017.md)
78+
| Tool | Tutorial |
79+
| --- | --- |
80+
| **[sqlcmd utility](../tools/sqlcmd/sqlcmd-utility.md)** | [Connect to SQL Server with sqlcmd](../tools/sqlcmd/sqlcmd-connect-database-engine.md) |
81+
| **[MSSQL extension for Visual Studio Code](../tools/visual-studio-code-extensions/mssql/mssql-extension-visual-studio-code.md)** | [Connect to and query a database with the MSSQL extension for Visual Studio Code](../tools/visual-studio-code-extensions/mssql/connect-database-visual-studio-code.md) |
82+
| **[SQL Server Management Studio (SSMS)](/ssms/sql-server-management-studio-ssms)** | [Use SQL Server Management Studio on Windows to manage SQL Server on Linux](sql-server-linux-manage-ssms.md) |
83+
| **[SQL Server Data Tools (SSDT)](../ssdt/sql-server-data-tools.md)** | [Use Visual Studio to create databases for SQL Server on Linux](sql-server-linux-develop-use-ssdt.md) |
6384

64-
To find out more about each release, see:
85+
## Explore
6586

66-
- [What's new for SQL Server 2025 on Linux](sql-server-linux-whats-new-2025.md)
67-
- [What's new for SQL Server 2022 on Linux](sql-server-linux-whats-new-2022.md)
68-
- [What's new for SQL Server 2019 on Linux](sql-server-linux-whats-new-2019.md)
69-
- [What's new for SQL Server 2017 on Linux](sql-server-linux-whats-new.md)
87+
[!INCLUDE [sssql17-md](../includes/sssql17-md.md)] and later versions have the same underlying [!INCLUDE [ssde-md](../includes/ssde-md.md)] on all supported platforms, including Linux and containers. Therefore, many existing features and capabilities operate the same way. This area of the documentation highlights some of these features from a Linux perspective and calls out areas that have unique requirements on Linux.
7088

71-
To see what's new in each version for Windows, see:
89+
If you're already familiar with [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] on Linux, review the release notes for general guidelines and known issues for each release.
7290

73-
- [What's new in SQL Server 2025](../sql-server/what-s-new-in-sql-server-2025.md)
74-
- [What's new in SQL Server 2022](../sql-server/what-s-new-in-sql-server-2022.md)
75-
- [What's new in SQL Server 2019](../sql-server/what-s-new-in-sql-server-2019.md)
76-
- [What's new in SQL Server 2017](../sql-server/what-s-new-in-sql-server-2017.md)
91+
| SQL Server version | Release notes (Linux) | What's new (Linux) | What's new (Windows) |
92+
| --- | --- | --- | --- |
93+
| [!INCLUDE [sssql25-md](../includes/sssql25-md.md)] | [Release notes](sql-server-linux-release-notes-2025.md) | [SQL Server on Linux](sql-server-linux-whats-new-2025.md) | [SQL Server on Windows](../sql-server/what-s-new-in-sql-server-2025.md) |
94+
| [!INCLUDE [sssql22-md](../includes/sssql25-md.md)] | [Release notes](sql-server-linux-release-notes-2022.md) | [SQL Server on Linux](sql-server-linux-whats-new-2022.md) | [SQL Server on Windows](../sql-server/what-s-new-in-sql-server-2022.md) |
95+
| [!INCLUDE [sssql19-md](../includes/sssql25-md.md)] | [Release notes](sql-server-linux-release-notes-2019.md) | [SQL Server on Linux](sql-server-linux-whats-new-2019.md) | [SQL Server on Windows](../sql-server/what-s-new-in-sql-server-2019.md) |
96+
| [!INCLUDE [sssql17-md](../includes/sssql25-md.md)] | [Release notes](sql-server-linux-release-notes-2017.md) | [SQL Server on Linux](sql-server-linux-whats-new-2017.md) | [SQL Server on Windows](../sql-server/what-s-new-in-sql-server-2017.md) |
7797

7898
> [!TIP]
7999
> For answers to frequently asked questions, see the [SQL Server on Linux FAQ](sql-server-linux-faq.yml).
File renamed without changes.

docs/sql-server/what-s-new-in-sql-server-2017.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -122,7 +122,7 @@ For more information, see [What's new in SQL Server Machine Learning Services?](
122122
## Related content
123123

124124
- [SQL Server 2017 release notes](sql-server-2017-release-notes.md)
125-
- [What's new for SQL Server 2017 on Linux](../linux/sql-server-linux-whats-new.md)
125+
- [What's new for SQL Server 2017 on Linux](../linux/sql-server-linux-whats-new-2017.md)
126126
- [What's new in SQL Server 2016](what-s-new-in-sql-server-2016.md)
127127

128128
[!INCLUDE [get-help-options](../includes/paragraph-content/get-help-options.md)]

docs/toc.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9059,7 +9059,7 @@ items:
90599059
- name: SQL Server 2019
90609060
href: linux/sql-server-linux-whats-new-2019.md
90619061
- name: SQL Server 2017
9062-
href: linux/sql-server-linux-whats-new.md
9062+
href: linux/sql-server-linux-whats-new-2017.md
90639063
- name: Editions and features
90649064
items:
90659065
- name: SQL Server 2025

0 commit comments

Comments
 (0)