You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/linux/quickstart-install-connect-ubuntu.md
+36-37Lines changed: 36 additions & 37 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,7 +3,7 @@ title: "Ubuntu: Install SQL Server on Linux"
3
3
description: This quickstart shows how to install SQL Server 2017 and later versions on Ubuntu and then create and query a database with sqlcmd.
4
4
author: rwestMSFT
5
5
ms.author: randolphwest
6
-
ms.date: 01/27/2026
6
+
ms.date: 02/04/2026
7
7
ms.service: sql
8
8
ms.subservice: linux
9
9
ms.topic: quickstart
@@ -47,7 +47,7 @@ For more information on supported platforms, see [Release notes for SQL Server 2
47
47
In this quickstart, you install [!INCLUDE [sssql25-md](../includes/sssql25-md.md)] on Ubuntu 22.04. Then you can connect with **sqlcmd** to create your first database and run queries.
48
48
49
49
> [!NOTE]
50
-
> Starting with [!INCLUDE [sssql25-md](../includes/sssql25-md.md)]CU 1, Ubuntu 24.04 is supported.
50
+
> Starting with [!INCLUDE [sssql25-md](../includes/sssql25-md.md)]Cumulative Update (CU) 1, Ubuntu 24.04 is supported.
51
51
52
52
For more information on supported platforms, see [Release notes for SQL Server 2025 on Linux](sql-server-linux-release-notes-2025.md).
53
53
@@ -64,7 +64,7 @@ For more information on supported platforms, see [Release notes for SQL Server 2
You must have an Ubuntu 18.04 machine with **at least 2 GB** of memory.
67
+
You need an Ubuntu 18.04 machine with **at least 2 GB** of memory.
68
68
69
69
To install Ubuntu 18.04 on your own machine, go to <https://releases.ubuntu.com/18.04/>. You can also create Ubuntu or Ubuntu Pro virtual machines in Azure. See [Tutorial: Create and Manage Linux VMs with the Azure CLI](/azure/virtual-machines/linux/tutorial-manage-vm).
70
70
@@ -74,7 +74,7 @@ If you previously installed a preview version of [!INCLUDE [ssnoversion-md](../i
You must have an Ubuntu 20.04 machine with **at least 2 GB** of memory.
77
+
You need an Ubuntu 20.04 machine with **at least 2 GB** of memory.
78
78
79
79
To install Ubuntu 20.04 on your own machine, go to <https://releases.ubuntu.com/20.04/>. You can also create Ubuntu or Ubuntu Pro virtual machines in Azure. See [Tutorial: Create and Manage Linux VMs with the Azure CLI](/azure/virtual-machines/linux/tutorial-manage-vm).
80
80
@@ -84,7 +84,7 @@ If you previously installed a preview version of [!INCLUDE [ssnoversion-md](../i
You must have an Ubuntu 20.04 machine with **at least 2 GB** of memory.
87
+
You need an Ubuntu 20.04 or Ubuntu 22.04 machine with **at least 2 GB** of memory.
88
88
89
89
To install Ubuntu 20.04 on your own machine, go to <https://releases.ubuntu.com/20.04/>. You can also create Ubuntu or Ubuntu Pro virtual machines in Azure. See [Tutorial: Create and Manage Linux VMs with the Azure CLI](/azure/virtual-machines/linux/tutorial-manage-vm).
90
90
@@ -94,24 +94,21 @@ If you previously installed a preview version of [!INCLUDE [ssnoversion-md](../i
You must have an Ubuntu 22.04 machine with **at least 2 GB** of memory.
97
+
You need an Ubuntu 22.04 or 24.04 machine with **at least 2 GB** of memory.
98
98
99
99
To install Ubuntu 22.04 on your own machine, go to <https://releases.ubuntu.com/22.04/>. You can also create Ubuntu or Ubuntu Pro virtual machines in Azure. See [Tutorial: Create and Manage Linux VMs with the Azure CLI](/azure/virtual-machines/linux/tutorial-manage-vm).
100
100
101
101
If you previously installed a preview version of [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)], you must first remove the old repository before following these steps. For more information, see [Configure repositories for installing and upgrading SQL Server 2025 on Linux](sql-server-linux-change-repo-2025.md).
102
102
103
103
::: moniker-end
104
104
105
-
> [!NOTE]
105
+
> [!NOTE]
106
106
> [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] on Windows Subsystem for Linux (WSL) is supported for development purposes only. For instructions on installing SQL Server on WSL, see [Quickstart: Install SQL Server and create a database on Windows Subsystem for Linux (WSL 2)](quickstart-install-connect-wsl-2.md).
107
107
108
108
For other system requirements, see [System requirements for SQL Server on Linux](sql-server-linux-setup.md#system).
109
109
110
-
> [!TIP]
111
-
> **Production and Compliance**
112
-
> For production environments that require **FIPS compliance** or expanded security maintenance (ESM) for the full open source stack (Universe repository), we recommend using **Ubuntu Pro**.
113
-
>
114
-
> You can enable Ubuntu Pro on your existing instance or select a pre-configured Ubuntu Pro image when provisioning in Azure.
110
+
> [!TIP]
111
+
> For production environments that require FIPS compliance or Expanded Security Maintenance (ESM) coverage for Ubuntu Universe packages, use **Ubuntu Pro**. You can enable Ubuntu Pro on your existing instance, or select a preconfigured Ubuntu Pro image when you provision your virtual machine in Azure.
115
112
116
113
<aid="install"></a>
117
114
@@ -137,14 +134,14 @@ To configure [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] on Ubunt
137
134
> [!TIP]
138
135
> If you want to install a different version of [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)], see the [SQL Server 2019](quickstart-install-connect-ubuntu.md?view=sql-server-linux-ver15&preserve-view=true#install), [SQL Server 2022](quickstart-install-connect-ubuntu.md?view=sql-server-linux-ver16&preserve-view=true#install), or [SQL Server 2025](quickstart-install-connect-ubuntu.md?view=sql-server-linux-ver17&preserve-view=true#install) versions of this article.
139
136
140
-
1.Run the following commands to install[!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)]:
1. After the package installation finishes, run `mssql-conf setup` and follow the prompts to set the `sa` password and choose your edition. As a reminder, the following [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] editions are freely licensed: Evaluation, Developer, and Express.
144
+
1. After the package installation finishes, run `mssql-conf setup` and follow the prompts to set the `sa` password and choose your edition. The following [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] editions are freely licensed: Evaluation, Developer, and Express.
148
145
149
146
```bash
150
147
sudo /opt/mssql/bin/mssql-conf setup
@@ -153,7 +150,7 @@ To configure [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] on Ubunt
1.Once the configuration is done, verify that the service is running:
153
+
1.When the configuration is done, verify that the service is running:
157
154
158
155
```bash
159
156
systemctl status mssql-server --no-pager
@@ -180,14 +177,14 @@ To configure [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] on Ubunt
180
177
> [!TIP]
181
178
> If you want to install a different version of [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)], see the [SQL Server 2017](quickstart-install-connect-ubuntu.md?view=sql-server-linux-2017&preserve-view=true#install), [SQL Server 2022](quickstart-install-connect-ubuntu.md?view=sql-server-linux-ver16&preserve-view=true#install), or [SQL Server 2025](quickstart-install-connect-ubuntu.md?view=sql-server-linux-ver17&preserve-view=true#install) versions of this article.
182
179
183
-
1.Run the following commands to install[!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)]:
1. After the package installation finishes, run `mssql-conf setup` and follow the prompts to set the `sa` password and choose your edition. As a reminder, the following [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] editions are freely licensed: Evaluation, Developer, and Express.
187
+
1. After the package installation finishes, run `mssql-conf setup` and follow the prompts to set the `sa` password and choose your edition. The following [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] editions are freely licensed: Evaluation, Developer, and Express.
191
188
192
189
```bash
193
190
sudo /opt/mssql/bin/mssql-conf setup
@@ -196,7 +193,7 @@ To configure [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] on Ubunt
1.Once the configuration is done, verify that the service is running:
196
+
1.When the configuration is done, verify that the service is running:
200
197
201
198
```bash
202
199
systemctl status mssql-server --no-pager
@@ -226,14 +223,14 @@ To configure [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] on Ubunt
226
223
> [!TIP]
227
224
> If you want to install a different version of [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)], see the [SQL Server 2017](quickstart-install-connect-ubuntu.md?view=sql-server-linux-2017&preserve-view=true#install), [SQL Server 2019](quickstart-install-connect-ubuntu.md?view=sql-server-linux-ver15&preserve-view=true#install), or [SQL Server 2025](quickstart-install-connect-ubuntu.md?view=sql-server-linux-ver17&preserve-view=true#install) versions of this article.
228
225
229
-
1.Run the following commands to install[!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)]:
1. After the package installation finishes, run `mssql-conf setup` and follow the prompts to set the `sa` password and choose your edition. As a reminder, the following [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] editions are freely licensed: Evaluation, Developer, and Express.
233
+
1. After the package installation finishes, run `mssql-conf setup` and follow the prompts to set the `sa` password and choose your edition. The following [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] editions are freely licensed: Evaluation, Developer, and Express.
237
234
238
235
```bash
239
236
sudo /opt/mssql/bin/mssql-conf setup
@@ -242,7 +239,7 @@ To configure [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] on Ubunt
If you receive a warning about the public key not being available, you can use the following command instead:
258
+
If you receive a warning about the public key not being available, use the following command instead:
262
259
263
260
```bash
264
261
curl https://packages.microsoft.com/keys/microsoft.asc | sudo tee /etc/apt/trusted.gpg.d/microsoft.asc
@@ -273,14 +270,14 @@ To configure [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] on Ubunt
273
270
> [!TIP]
274
271
> If you want to install a different version of [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)], see the [SQL Server 2017](quickstart-install-connect-ubuntu.md?view=sql-server-linux-2017&preserve-view=true#install), [SQL Server 2019](quickstart-install-connect-ubuntu.md?view=sql-server-linux-ver15&preserve-view=true#install), or [SQL Server 2025](quickstart-install-connect-ubuntu.md?view=sql-server-linux-ver17&preserve-view=true#install) versions of this article.
275
272
276
-
1.Run the following commands to install[!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)]:
1. After the package installation finishes, run `mssql-conf setup` and follow the prompts to set the `sa` password and choose your edition. As a reminder, the following [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] editions are freely licensed: Evaluation, Developer, and Express.
280
+
1. After the package installation finishes, run `mssql-conf setup` and follow the prompts to set the `sa` password and choose your edition. The following [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] editions are freely licensed: Evaluation, Developer, and Express.
284
281
285
282
```bash
286
283
sudo /opt/mssql/bin/mssql-conf setup
@@ -289,7 +286,7 @@ To configure [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] on Ubunt
If you receive a warning about the public key not being available, you can use the following command instead:
312
+
If you receive a warning about the public key not being available, use the following command instead:
316
313
317
314
```bash
318
315
curl https://packages.microsoft.com/keys/microsoft.asc | sudo tee /etc/apt/trusted.gpg.d/microsoft.asc
@@ -325,16 +322,16 @@ To configure [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] on Ubunt
325
322
```
326
323
327
324
> [!TIP]
328
-
> If you want to install a different version of [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)], see the [SQL Server 2017](quickstart-install-connect-ubuntu.md?view=sql-server-linux-2017&preserve-view=true#install), [SQL Server 2019](quickstart-install-connect-ubuntu.md?view=sql-server-linux-ver15&preserve-view=true#install), or [SQL Server 2022](quickstart-install-connect-ubuntu.md?view=sql-server-linux-ver16&preserve-view=true#install) versions of this article.
325
+
> To install a different version of [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)], see the [SQL Server 2017](quickstart-install-connect-ubuntu.md?view=sql-server-linux-2017&preserve-view=true#install), [SQL Server 2019](quickstart-install-connect-ubuntu.md?view=sql-server-linux-ver15&preserve-view=true#install), or [SQL Server 2022](quickstart-install-connect-ubuntu.md?view=sql-server-linux-ver16&preserve-view=true#install) versions of this article.
329
326
330
-
1.Run the following commands to install[!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)]:
1. After the package installation finishes, run `mssql-conf setup` and follow the prompts to set the `sa` password and choose your edition. As a reminder, the following [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] editions are freely licensed: Evaluation, Developer, and Express.
334
+
1. After the package installation finishes, run `mssql-conf setup` and follow the prompts to set the `sa` password and choose your edition. The following [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] editions are freely licensed: Evaluation, Developer, and Express.
338
335
339
336
```bash
340
337
sudo /opt/mssql/bin/mssql-conf setup
@@ -343,7 +340,7 @@ To configure [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] on Ubunt
@@ -368,16 +367,16 @@ At this point, [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] is run
368
367
```
369
368
370
369
> [!TIP]
371
-
> If you want to install a different version of [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)], see the [SQL Server 2017](quickstart-install-connect-ubuntu.md?view=sql-server-linux-2017&preserve-view=true#install), [SQL Server 2019](quickstart-install-connect-ubuntu.md?view=sql-server-linux-ver15&preserve-view=true#install), or [SQL Server 2022](quickstart-install-connect-ubuntu.md?view=sql-server-linux-ver16&preserve-view=true#install) versions of this article.
370
+
> To install a different version of [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)], see the [SQL Server 2017](quickstart-install-connect-ubuntu.md?view=sql-server-linux-2017&preserve-view=true#install), [SQL Server 2019](quickstart-install-connect-ubuntu.md?view=sql-server-linux-ver15&preserve-view=true#install), or [SQL Server 2022](quickstart-install-connect-ubuntu.md?view=sql-server-linux-ver16&preserve-view=true#install) versions of this article.
372
371
373
-
1.Run the following commands to install[!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)]:
1. After the package installation finishes, run `mssql-conf setup` and follow the prompts to set the `sa` password and choose your edition. As a reminder, the following [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] editions are freely licensed: Evaluation, Developer, and Express.
379
+
1. After the package installation finishes, run `mssql-conf setup` and follow the prompts to set the `sa` password and choose your edition. The following [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] editions are freely licensed: Evaluation, Developer, and Express.
381
380
382
381
```bash
383
382
sudo /opt/mssql/bin/mssql-conf setup
@@ -386,7 +385,7 @@ At this point, [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] is run
0 commit comments