Skip to content

Commit 7a49ecd

Browse files
committed
Edit pass
1 parent 0d4937b commit 7a49ecd

1 file changed

Lines changed: 36 additions & 37 deletions

File tree

docs/linux/quickstart-install-connect-ubuntu.md

Lines changed: 36 additions & 37 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: "Ubuntu: Install SQL Server on Linux"
33
description: This quickstart shows how to install SQL Server 2017 and later versions on Ubuntu and then create and query a database with sqlcmd.
44
author: rwestMSFT
55
ms.author: randolphwest
6-
ms.date: 01/27/2026
6+
ms.date: 02/04/2026
77
ms.service: sql
88
ms.subservice: linux
99
ms.topic: quickstart
@@ -47,7 +47,7 @@ For more information on supported platforms, see [Release notes for SQL Server 2
4747
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.
4848

4949
> [!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.
5151
5252
For more information on supported platforms, see [Release notes for SQL Server 2025 on Linux](sql-server-linux-release-notes-2025.md).
5353

@@ -64,7 +64,7 @@ For more information on supported platforms, see [Release notes for SQL Server 2
6464
<!--SQL Server 2017 on Linux-->
6565
::: moniker range="=sql-server-linux-2017 || =sql-server-2017"
6666

67-
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.
6868

6969
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).
7070

@@ -74,7 +74,7 @@ If you previously installed a preview version of [!INCLUDE [ssnoversion-md](../i
7474
<!--SQL Server 2019 on Linux-->
7575
::: moniker range="=sql-server-linux-ver15 || =sql-server-ver15"
7676

77-
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.
7878

7979
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).
8080

@@ -84,7 +84,7 @@ If you previously installed a preview version of [!INCLUDE [ssnoversion-md](../i
8484
<!--SQL Server 2022 on Linux-->
8585
::: moniker range="=sql-server-linux-ver16 || =sql-server-ver16"
8686

87-
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.
8888

8989
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).
9090

@@ -94,24 +94,21 @@ If you previously installed a preview version of [!INCLUDE [ssnoversion-md](../i
9494
<!--SQL Server 2025 on Linux-->
9595
::: moniker range=">=sql-server-linux-ver17 || >=sql-server-ver17"
9696

97-
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.
9898

9999
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).
100100

101101
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).
102102

103103
::: moniker-end
104104

105-
> [!NOTE]
105+
> [!NOTE]
106106
> [!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).
107107
108108
For other system requirements, see [System requirements for SQL Server on Linux](sql-server-linux-setup.md#system).
109109

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.
115112
116113
<a id="install"></a>
117114

@@ -137,14 +134,14 @@ To configure [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] on Ubunt
137134
> [!TIP]
138135
> 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.
139136
140-
1. Run the following commands to install [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)]:
137+
1. Install [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)]:
141138

142139
```bash
143140
sudo apt-get update
144141
sudo apt-get install -y mssql-server
145142
```
146143

147-
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.
148145

149146
```bash
150147
sudo /opt/mssql/bin/mssql-conf setup
@@ -153,7 +150,7 @@ To configure [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] on Ubunt
153150
> [!CAUTION]
154151
> [!INCLUDE [password-complexity](includes/password-complexity.md)]
155152
156-
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:
157154

158155
```bash
159156
systemctl status mssql-server --no-pager
@@ -180,14 +177,14 @@ To configure [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] on Ubunt
180177
> [!TIP]
181178
> 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.
182179
183-
1. Run the following commands to install [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)]:
180+
1. Install [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)]:
184181

185182
```bash
186183
sudo apt-get update
187184
sudo apt-get install -y mssql-server
188185
```
189186

190-
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.
191188

192189
```bash
193190
sudo /opt/mssql/bin/mssql-conf setup
@@ -196,7 +193,7 @@ To configure [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] on Ubunt
196193
> [!CAUTION]
197194
> [!INCLUDE [password-complexity](includes/password-complexity.md)]
198195
199-
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:
200197

201198
```bash
202199
systemctl status mssql-server --no-pager
@@ -226,14 +223,14 @@ To configure [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] on Ubunt
226223
> [!TIP]
227224
> 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.
228225
229-
1. Run the following commands to install [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)]:
226+
1. Install [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)]:
230227

231228
```bash
232229
sudo apt-get update
233230
sudo apt-get install -y mssql-server
234231
```
235232

236-
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.
237234

238235
```bash
239236
sudo /opt/mssql/bin/mssql-conf setup
@@ -242,7 +239,7 @@ To configure [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] on Ubunt
242239
> [!CAUTION]
243240
> [!INCLUDE [password-complexity](includes/password-complexity.md)]
244241
245-
1. Once the configuration is done, verify that the service is running:
242+
1. When the configuration is done, verify that the service is running:
246243

247244
```bash
248245
systemctl status mssql-server --no-pager
@@ -252,13 +249,13 @@ To configure [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] on Ubunt
252249

253250
### [Ubuntu 22.04](#tab/ubuntu2204)
254251

255-
1. Download the public key, convert from ASCII to GPG format, and write it to the required location:
252+
1. Download the public key, convert it from ASCII to GPG format, and write it to the required location:
256253

257254
```bash
258255
curl -fsSL https://packages.microsoft.com/keys/microsoft.asc | sudo gpg --dearmor -o /usr/share/keyrings/microsoft-prod.gpg
259256
```
260257

261-
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:
262259

263260
```bash
264261
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
273270
> [!TIP]
274271
> 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.
275272
276-
1. Run the following commands to install [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)]:
273+
1. Install [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)]:
277274

278275
```bash
279276
sudo apt-get update
280277
sudo apt-get install -y mssql-server
281278
```
282279

283-
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.
284281

285282
```bash
286283
sudo /opt/mssql/bin/mssql-conf setup
@@ -289,7 +286,7 @@ To configure [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] on Ubunt
289286
> [!CAUTION]
290287
> [!INCLUDE [password-complexity](includes/password-complexity.md)]
291288
292-
1. Once the configuration is done, verify that the service is running:
289+
1. When the configuration is done, verify that the service is running:
293290

294291
```bash
295292
systemctl status mssql-server --no-pager
@@ -306,13 +303,13 @@ To configure [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] on Ubunt
306303

307304
### [Ubuntu 22.04](#tab/2025ubuntu2204)
308305

309-
1. Download the public key, convert from ASCII to GPG format, and write it to the required location:
306+
1. Download the public key, convert it from ASCII to GPG format, and write it to the required location:
310307

311308
```bash
312309
curl -fsSL https://packages.microsoft.com/keys/microsoft.asc | sudo gpg --dearmor -o /usr/share/keyrings/microsoft-prod.gpg
313310
```
314311

315-
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:
316313

317314
```bash
318315
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
325322
```
326323

327324
> [!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.
329326
330-
1. Run the following commands to install [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)]:
327+
1. Install [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)]:
331328

332329
```bash
333330
sudo apt-get update
334331
sudo apt-get install -y mssql-server
335332
```
336333

337-
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.
338335

339336
```bash
340337
sudo /opt/mssql/bin/mssql-conf setup
@@ -343,7 +340,7 @@ To configure [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] on Ubunt
343340
> [!CAUTION]
344341
> [!INCLUDE [password-complexity](includes/password-complexity.md)]
345342
346-
1. Once the configuration is done, verify that the service is running:
343+
1. When the configuration is done, verify that the service is running:
347344

348345
```bash
349346
systemctl status mssql-server --no-pager
@@ -355,7 +352,9 @@ At this point, [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] is run
355352

356353
### [Ubuntu 24.04](#tab/2505ubuntu2404)
357354

358-
1. Download the public key, convert from ASCII to GPG format, and write it to the required location:
355+
**Applies to**: [!INCLUDE [sssql25-md](../includes/sssql25-md.md)] CU 1 and later versions.
356+
357+
1. Download the public key, convert it from ASCII to GPG format, and write it to the required location:
359358

360359
```bash
361360
curl -fsSL https://packages.microsoft.com/keys/microsoft.asc | sudo gpg --dearmor -o /usr/share/keyrings/microsoft-prod.gpg
@@ -368,16 +367,16 @@ At this point, [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] is run
368367
```
369368

370369
> [!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.
372371
373-
1. Run the following commands to install [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)]:
372+
1. Install [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)]:
374373

375374
```bash
376375
sudo apt-get update
377376
sudo apt-get install -y mssql-server
378377
```
379378

380-
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.
381380

382381
```bash
383382
sudo /opt/mssql/bin/mssql-conf setup
@@ -386,7 +385,7 @@ At this point, [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] is run
386385
> [!CAUTION]
387386
> [!INCLUDE [password-complexity](includes/password-complexity.md)]
388387
389-
1. Once the configuration is done, verify that the service is running:
388+
1. When the configuration is done, verify that the service is running:
390389

391390
```bash
392391
systemctl status mssql-server --no-pager

0 commit comments

Comments
 (0)