Linux updates for GA (#35853)

rwestMSFT · web-flow · commit 7208fd082986 · 2025-11-18T13:24:23.000-05:00
diff --git a/docs/linux/includes/editions-sql-server-2022-earlier-versions.md b/docs/linux/includes/editions-sql-server-2022-earlier-versions.md
@@ -0,0 +1,21 @@
+---
+author: rwestMSFT
+ms.author: randolphwest
+ms.date: 11/18/2025
+ms.service: sql
+ms.topic: include
+ms.custom:
+  - linux-related-content
+---
+| `MSSQL_PID` | Edition |
+| --- | --- |
+| `Evaluation` | SQL Server Evaluation edition |
+| `Developer` | SQL Server Developer edition |
+| `Express` | SQL Server Express edition |
+| `Web` | SQL Server Web edition |
+| `Standard` | SQL Server Standard edition |
+| `Enterprise` | This legacy option represents Enterprise edition Server + Client Access License (CAL) based licensing, and is limited to a maximum of 20 cores per SQL Server instance. `Enterprise` isn't available for new agreements. You should choose `EnterpriseCore` when you wish to deploy Enterprise edition. |
+| `EnterpriseCore` | SQL Server Enterprise Core edition. `EnterpriseCore` represents the core-based server licensing model with no core limits. For more information, see [Compute capacity limits by edition of SQL Server](../../sql-server/compute-capacity-limits-by-edition-of-sql-server.md). |
+| `A product key` | If you specify a product key, it must be in the form of `#####-#####-#####-#####-#####`, where `#` is a number or a letter. |
+
+For more information about these editions, see [SQL Server editions](../../sql-server/editions-and-components-of-sql-server-2025.md#sql-server-editions).
diff --git a/docs/linux/includes/editions-sql-server-2025-later-versions.md b/docs/linux/includes/editions-sql-server-2025-later-versions.md
@@ -0,0 +1,21 @@
+---
+author: rwestMSFT
+ms.author: randolphwest
+ms.date: 11/18/2025
+ms.service: sql
+ms.topic: include
+ms.custom:
+  - linux-related-content
+---
+| `MSSQL_PID` | Edition |
+| --- | --- |
+| `Evaluation` | SQL Server Evaluation edition |
+| `Express` | SQL Server Express edition |
+| `StandardDeveloper` | SQL Server Developer edition |
+| `Standard` | SQL Server Standard edition |
+| `EnterpriseDeveloper` | SQL Server Developer edition |
+| `Enterprise` | This legacy option represents Enterprise edition Server + Client Access License (CAL) based licensing, and is limited to a maximum of 20 cores per SQL Server instance. `Enterprise` isn't available for new agreements. You should choose `EnterpriseCore` when you wish to deploy Enterprise edition. |
+| `EnterpriseCore` | SQL Server Enterprise Core edition. `EnterpriseCore` represents the core-based server licensing model with no core limits. For more information, see [Compute capacity limits by edition of SQL Server](../../sql-server/compute-capacity-limits-by-edition-of-sql-server.md). |
+| `A product key` | If you specify a product key, it must be in the form of `#####-#####-#####-#####-#####`, where `#` is a number or a letter. |
+
+For more information about these editions, see [SQL Server editions](../../sql-server/editions-and-components-of-sql-server-2025.md#sql-server-editions).
diff --git a/docs/linux/includes/editions-sql-server-developer.md b/docs/linux/includes/editions-sql-server-developer.md
@@ -0,0 +1,10 @@
+---
+author: rwestMSFT
+ms.author: randolphwest
+ms.date: 11/18/2025
+ms.service: sql
+ms.topic: include
+ms.custom:
+  - linux-related-content
+---
+When you deploy a container for [!INCLUDE [sssql25-md](../../includes/sssql25-md.md)] or a later version, use `MSSQL_PID=DeveloperStandard` for Standard Developer edition, and `MSSQL_PID=Developer` for Enterprise Developer edition.
diff --git a/docs/linux/quickstart-install-connect-wsl-2.md b/docs/linux/quickstart-install-connect-wsl-2.md
@@ -162,6 +162,8 @@ docker run -e "ACCEPT_EULA=Y" -e "MSSQL_SA_PASSWORD=<password>" \
 -d mcr.microsoft.com/mssql/server:2022-latest
 ```
 
+[!INCLUDE [editions-sql-server-developer](includes/editions-sql-server-developer.md)]
+
 > [!NOTE]  
 > [!INCLUDE [password-complexity](includes/password-complexity.md)]
 
@@ -179,6 +181,8 @@ docker run -e "ACCEPT_EULA=Y" -e "MSSQL_SA_PASSWORD=<password>" \
 -d mcr.microsoft.com/mssql/server:2022-latest
 ```
 
+[!INCLUDE [editions-sql-server-developer](includes/editions-sql-server-developer.md)]
+
 Even if you run the `wsl --terminate` command, the data isn't lost. When you start up WSL again and run the `docker run` command to deploy using the `sql_volume` volume, it still has all the data intact.
 
 If you want to delete the persisted volume, make sure that the container using the volume is stopped and removed, and run the following command.
diff --git a/docs/linux/quickstart-sql-server-containers-azure.md b/docs/linux/quickstart-sql-server-containers-azure.md
@@ -336,6 +336,8 @@ You create a manifest to describe the container, based on the SQL Server [mssql-
 
    - MSSQL_PID `value: "Developer"`: Sets the container to run SQL Server Developer edition. Developer edition isn't licensed for production data. If the deployment is for production use, set the appropriate edition (`Enterprise`, `Standard`, or `Express`). For more information, see [How to license SQL Server](https://www.microsoft.com/sql-server/sql-server-2022-pricing).
 
+     [!INCLUDE [editions-sql-server-developer](includes/editions-sql-server-developer.md)]
+
    - `persistentVolumeClaim`: This value requires an entry for `claimName:` that maps to the name used for the persistent volume claim. This tutorial uses `mssql-data`.
 
    - `name: MSSQL_SA_PASSWORD`: Configures the container image to set the `sa` password, as defined in this section.
diff --git a/docs/linux/sql-server-linux-configure-environment-variables.md b/docs/linux/sql-server-linux-configure-environment-variables.md
@@ -30,7 +30,7 @@ You can use several different environment variables to configure [!INCLUDE [ssno
 | --- | --- |
 | `ACCEPT_EULA` | Set the `ACCEPT_EULA` variable to any value to confirm your acceptance of the [End-User Licensing Agreement](https://go.microsoft.com/fwlink/?LinkId=746388). Required setting for the SQL Server image. |
 | `MSSQL_SA_PASSWORD` | Configure the `sa` password.<br /><br />The `SA_PASSWORD` environment variable is deprecated. Use `MSSQL_SA_PASSWORD` instead. |
-| `MSSQL_PID` | Set the SQL Server edition or product key. Possible values include:<br /><br />`Evaluation`<br />`Developer`<br />`Express`<br />`Web`<br />`Standard`<br />`Enterprise` <sup>1</sup><br />`EnterpriseCore` <sup>1</sup><br />`A product key`<br /><br />If specifying a product key, it must be in the form of #####-#####-#####-#####-#####, where '#' is a number or a letter. |
+| `MSSQL_PID` | Set the [SQL Server edition](../sql-server/editions-and-components-of-sql-server-2025.md#sql-server-editions) or product key. Possible values are listed in the following [SQL Server editions](#sql-server-editions) table. If you specify a product key, it must be in the form of `#####-#####-#####-#####-#####`, where `#` is a number or a letter. |
 | `MSSQL_LCID` | Sets the language ID to use for SQL Server. For example, 1036 is French. |
 | `MSSQL_COLLATION` | Sets the default collation for SQL Server. This overrides the default mapping of language ID (LCID) to collation. |
 | `MSSQL_MEMORY_LIMIT_MB` | Sets the maximum amount of memory (in MB) that SQL Server can use. By default, it's 80% of the total physical memory. |
@@ -46,7 +46,15 @@ You can use several different environment variables to configure [!INCLUDE [ssno
 | `MSSQL_MASTER_LOG_FILE` | Sets the location of the `master` database log file. Must be named `mastlog.ldf` until first run of SQL Server. |
 | `MSSQL_ERROR_LOG_FILE` | Sets the location of the `errorlog` files. For example, `/var/opt/mssql/log/errorlog`. |
 
-<sup>1</sup> The legacy `Enterprise` license represents Enterprise edition with Server + Client Access License (CAL) based licensing, and is limited to a maximum of 20 cores per SQL Server instance. `Enterprise` isn't available for new agreements. You should choose `EnterpriseCore` when you wish to deploy Enterprise edition. `EnterpriseCore` represents the core-based server licensing model with no core limits. For more information, see [Compute capacity limits by edition of SQL Server](../sql-server/compute-capacity-limits-by-edition-of-sql-server.md).
+### SQL Server editions
+
+:::moniker range="<=sql-server-ver16 || <=sql-server-linux-ver16"
+[!INCLUDE [editions-sql-server-2022-earlier-versions](includes/editions-sql-server-2022-earlier-versions.md)]
+:::moniker-end
+
+:::moniker range=">=sql-server-ver17 || >=sql-server-linux-ver17"
+[!INCLUDE [editions-sql-server-2025-later-versions](includes/editions-sql-server-2025-later-versions.md)]
+:::moniker-end
 
 ## Use with initial setup
 
@@ -72,6 +80,8 @@ This example `docker` command uses the following environment variables to create
 
 - `MSSQL_PID` specifies the freely licensed Developer Edition of SQL Server for non-production use.
 
+   [!INCLUDE [editions-sql-server-developer](includes/editions-sql-server-developer.md)]
+
 - `MSSQL_SA_PASSWORD` sets a strong password. [!INCLUDE [password-complexity](includes/password-complexity.md)]
 
 - `MSSQL_TCP_PORT` sets the TCP port that SQL Server listens on to 1234. This means that instead of mapping port 1433 (default) to a host port, the custom TCP port must be mapped with the `-p 1234:1234` command in this example.
@@ -146,6 +156,8 @@ docker run -e ACCEPT_EULA=Y -e MSSQL_PID="Developer" -e MSSQL_SA_PASSWORD="<pass
 
 ::: moniker-end
 
+[!INCLUDE [editions-sql-server-developer](includes/editions-sql-server-developer.md)]
+
 > [!CAUTION]  
 > [!INCLUDE [password-complexity](includes/password-complexity.md)]
 
diff --git a/docs/linux/sql-server-linux-containers-deploy-helm-charts-kubernetes.md b/docs/linux/sql-server-linux-containers-deploy-helm-charts-kubernetes.md
@@ -95,6 +95,8 @@ Deploy SQL Server using the following command. The deployment name is customizab
 helm install mssql-latest-deploy . --set ACCEPT_EULA.value=Y --set MSSQL_PID.value=Developer
 ```
 
+[!INCLUDE [editions-sql-server-developer](includes/editions-sql-server-developer.md)]
+
 In the previous example, the chart and its files are in the current directory, represented by the period (`.`). You can specify the path of the chart if you prefer.
 
 If successful, you see similar output:
diff --git a/docs/linux/sql-server-linux-docker-container-deployment.md b/docs/linux/sql-server-linux-docker-container-deployment.md
@@ -386,6 +386,8 @@ docker run --name sqlenterprise ^
 > [!IMPORTANT]  
 > By passing the value `Y` to the environment variable `ACCEPT_EULA` and an edition value to `MSSQL_PID`, you express that you have a valid and existing license for the edition and version of SQL Server that you intend to use. You also agree that your use of SQL Server software running in a container image will be governed by the terms of your SQL Server license.
 
+[!INCLUDE [editions-sql-server-developer](includes/editions-sql-server-developer.md)]
+
 For a full list of possible values for `MSSQL_PID`, see [Configure SQL Server settings with environment variables on Linux](sql-server-linux-configure-environment-variables.md).
 
 <a id="multiple"></a>
diff --git a/docs/linux/sql-server-linux-docker-container-troubleshooting.md b/docs/linux/sql-server-linux-docker-container-troubleshooting.md
@@ -307,6 +307,8 @@ docker run -e "ACCEPT_EULA=Y" -e "MSSQL_SA_PASSWORD=<password>" -e "MSSQL_PID=De
 
 ::: moniker-end
 
+[!INCLUDE [editions-sql-server-developer](includes/editions-sql-server-developer.md)]
+
 > [!CAUTION]  
 > [!INCLUDE [password-complexity](includes/password-complexity.md)]
 
diff --git a/docs/linux/sql-server-linux-editions-and-components-2025.md b/docs/linux/sql-server-linux-editions-and-components-2025.md
@@ -65,7 +65,7 @@ You can install just the [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.m
 | --- | --- |
 | [!INCLUDE [ssDEnoversion](../includes/ssdenoversion-md.md)] | [!INCLUDE [ssDEnoversion](../includes/ssdenoversion-md.md)] includes the [!INCLUDE [ssDE](../includes/ssde-md.md)], the core service for storing, processing, and securing data, replication, Full-Text Search, tools for managing relational and XML data, and in database analytics integration. |
 
-**Developer, Enterprise Core, and Evaluation editions**
+**Enterprise Developer, Standard Developer, Enterprise Core, and Evaluation editions**
 
 For features supported by Enterprise Developer, Standard Developer, Enterprise Core, and Evaluation editions, see features listed for the SQL Server Enterprise edition in the following tables.
 
diff --git a/docs/linux/sql-server-linux-setup-machine-learning-docker.md b/docs/linux/sql-server-linux-setup-machine-learning-docker.md
@@ -67,8 +67,10 @@ Complete the following steps to build the docker image:
    docker run -d -e MSSQL_PID=Developer -e ACCEPT_EULA=Y -e ACCEPT_EULA_ML=Y -e MSSQL_SA_PASSWORD=<password> -v <directory on the host OS>:/var/opt/mssql -p 1433:1433 mssql-server-mlservices
    ```
 
+   [!INCLUDE [editions-sql-server-developer](includes/editions-sql-server-developer.md)]
+
    > [!NOTE]  
-   > Any of the following values can be used for MSSQL_PID: Developer (free), Express (free), Enterprise (paid), Standard (paid). If you use a paid edition, ensure that you have purchased a license. Replace `<password>` with your actual password. Volume mounting using `-v` is optional. Replace `<directory on the host OS>` with an actual directory where you want to mount the database data and log files.
+   > Any of the [supported values](sql-server-linux-configure-environment-variables.md#sql-server-editions) can be used for `MSSQL_PID`. If you use a paid edition, ensure that you have purchased a license. Replace `<password>` with your actual password. Volume mounting using `-v` is optional. Replace `<directory on the host OS>` with an actual directory where you want to mount the database data and log files.
 
 1. Confirm by running the following command:
 
