Merge pull request #35496 from rwestMSFT/rw-1006-linux-emulator-support

v-shils · web-flow · commit e86d47bd69db · 2025-10-07T11:59:05.000-07:00
Linux: Clarify no support for emulated containers
diff --git a/docs/linux/includes/container-emulation.md b/docs/linux/includes/container-emulation.md
@@ -0,0 +1,10 @@
+---
+author: rwestMSFT
+ms.author: randolphwest
+ms.date: 10/06/2025
+ms.service: sql
+ms.topic: include
+ms.custom:
+  - linux-related-content
+---
+[!INCLUDE [ssnoversion-md](../../includes/ssnoversion-md.md)] container images are supported only on Linux hosts running on [Intel and AMD x86-64 CPUs](../../sql-server/install/hardware-and-software-requirements-for-installing-sql-server-2025.md#hardware-requirements). Emulation or translation environments (for example, Rosetta 2, Prism, or QEMU) aren't tested or supported. If you want to create a feature request, or report an emulator-related issue, visit the [official GitHub repository](https://github.com/microsoft/mssql-docker/issues).
diff --git a/docs/linux/includes/linux-supported-platforms-2017.md b/docs/linux/includes/linux-supported-platforms-2017.md
@@ -15,13 +15,15 @@ ms.custom:
 | Red Hat Enterprise Linux 7.7 - 7.9 Server <sup>1</sup>, or 8.x Server | **XFS** or **ext4** | [Installation guide](../quickstart-install-connect-red-hat.md) |
 | SUSE Linux Enterprise Server v12 SP3 - SP5 <sup>2</sup> | **XFS** or **ext4** | [Installation guide](../quickstart-install-connect-suse.md) |
 | Ubuntu 18.04 LTS <sup>3</sup> | **XFS** or **ext4** | [Installation guide](../quickstart-install-connect-ubuntu.md) |
-| Docker Engine 1.8+ on Linux | N/A | [Installation guide](../quickstart-install-connect-docker.md) |
+| Docker Engine 1.8+ on Linux <sup>4</sup> | N/A | [Installation guide](../quickstart-install-connect-docker.md) |
 
 <sup>1</sup> At the end of June 2024, RHEL 7.x transitioned from mainstream maintenance to extended lifecycle support (ELS). For more information, see [Red Hat Enterprise Linux Life Cycle](https://access.redhat.com/support/policy/updates/errata/).
 
 <sup>2</sup> At the end of Oct 2024, SLES v12 transitioned from standard general support to long term service pack support (LTSS). For more information, see [Product Support Lifecycle Lifecycle Dates by Product](https://www.suse.com/lifecycle#suse-linux-enterprise-server-12).
 
 <sup>3</sup> At the end of April 2023, Ubuntu 18.04 LTS transitioned from standard maintenance to expanded security maintenance (ESM). For more information, see [Ubuntu 18.04 end of standard support](https://ubuntu.com/blog/18-04-end-of-standard-support).
 
+<sup>4</sup> [!INCLUDE [container-emulation](container-emulation.md)]
+
 > [!TIP]  
 > For more information, review the [system requirements](../sql-server-linux-setup.md#system) for [!INCLUDE [ssNoVersion](../../includes/ssnoversion-md.md)] on Linux. For the latest support policy for [!INCLUDE [ssnoversion-md](../../includes/ssnoversion-md.md)], see the [Technical support policy for Microsoft SQL Server](/troubleshoot/sql/general/support-policy-sql-server).
diff --git a/docs/linux/includes/linux-supported-platforms-2019.md b/docs/linux/includes/linux-supported-platforms-2019.md
@@ -17,13 +17,15 @@ You should run production workloads on supported platforms like [Red Hat Enterpr
 | Red Hat Enterprise Linux 7.7 - 7.9 Server <sup>1</sup>, or 8.x Server | **XFS** or **ext4** | [Installation guide](../quickstart-install-connect-red-hat.md) | [Get RHEL 8](https://access.redhat.com/products/red-hat-enterprise-linux/evaluation) |
 | SUSE Linux Enterprise Server v12 (SP3 - SP5) <sup>2</sup>, or v15 | **XFS** or **ext4** | [Installation guide](../quickstart-install-connect-suse.md) | [Get SLES v15](https://www.suse.com/products/server) |
 | Ubuntu 18.04 <sup>3</sup> or 20.04 | **XFS** or **ext4** | [Installation guide](../quickstart-install-connect-ubuntu.md) | [Get Ubuntu 20.04](https://releases.ubuntu.com/20.04/) |
-| Docker Engine 1.8+ on Windows, Mac, or Linux | N/A | [Installation guide](../quickstart-install-connect-docker.md) | [Get Docker](https://www.docker.com/get-started) |
+| Docker Engine 1.8+ on Linux <sup>4</sup> | N/A | [Installation guide](../quickstart-install-connect-docker.md) | [Get Docker](https://www.docker.com/get-started) |
 
 <sup>1</sup> At the end of June 2024, RHEL 7.x transitioned from mainstream maintenance to extended lifecycle support (ELS). For more information, see [Red Hat Enterprise Linux Life Cycle](https://access.redhat.com/support/policy/updates/errata/).
 
 <sup>2</sup> At the end of Oct 2024, SLES v12 transitioned from standard general support to long term service pack support (LTSS). For more information, see [Product Support Lifecycle Lifecycle Dates by Product](https://www.suse.com/lifecycle#suse-linux-enterprise-server-12).
 
 <sup>3</sup> At the end of April 2023, Ubuntu 18.04 LTS transitioned from standard maintenance to expanded security maintenance (ESM). For more information, see [Ubuntu 18.04 end of standard support](https://ubuntu.com/blog/18-04-end-of-standard-support).
 
+<sup>4</sup> [!INCLUDE [container-emulation](container-emulation.md)]
+
 > [!TIP]  
 > For more information, review the [system requirements](../sql-server-linux-setup.md#system) for [!INCLUDE [ssnoversion-md](../../includes/ssnoversion-md.md)] on Linux. For the latest support policy for [!INCLUDE [ssNoVersion](../../includes/ssnoversion-md.md)], see the [Technical support policy for Microsoft SQL Server](/troubleshoot/sql/general/support-policy-sql-server).
diff --git a/docs/linux/includes/linux-supported-platforms-2022.md b/docs/linux/includes/linux-supported-platforms-2022.md
@@ -17,7 +17,9 @@ You should run production workloads on supported platforms like [Red Hat Enterpr
 | Red Hat Enterprise Linux 8.x Server, or 9.x Server | **XFS** or **ext4** | [Installation guide](../quickstart-install-connect-red-hat.md) | [Get RHEL 9](https://access.redhat.com/products/red-hat-enterprise-linux/evaluation) |
 | SUSE Linux Enterprise Server v15 (SP1 - SP4) | **XFS** or **ext4** | [Installation guide](../quickstart-install-connect-suse.md) | [Get SLES v15](https://www.suse.com/products/server) |
 | Ubuntu 20.04, or 22.04 | **XFS** or **ext4** | [Installation guide](../quickstart-install-connect-ubuntu.md) | [Get Ubuntu 22.04](https://releases.ubuntu.com/22.04/) |
-| Docker Engine 1.8+ on Linux | N/A | [Installation guide](../quickstart-install-connect-docker.md) | [Get Docker](https://www.docker.com/get-started) |
+| Docker Engine 1.8+ on Linux <sup>1</sup> | N/A | [Installation guide](../quickstart-install-connect-docker.md) | [Get Docker](https://www.docker.com/get-started) |
+
+<sup>1</sup> [!INCLUDE [container-emulation](container-emulation.md)]
 
 > [!TIP]  
 > For more information, review the [system requirements](../sql-server-linux-setup.md#system) for [!INCLUDE [ssnoversion-md](../../includes/ssnoversion-md.md)] on Linux. For the latest support policy for [!INCLUDE [ssNoVersion](../../includes/ssnoversion-md.md)], see the [Technical support policy for Microsoft SQL Server](/troubleshoot/sql/general/support-policy-sql-server).
diff --git a/docs/linux/includes/linux-supported-platforms-2025.md b/docs/linux/includes/linux-supported-platforms-2025.md
@@ -16,7 +16,9 @@ You should run production workloads on supported platforms like [Red Hat Enterpr
 | Red Hat Enterprise Linux 9.x Server | **XFS** or **ext4** | [Installation guide](../quickstart-install-connect-red-hat.md) | [Get RHEL 9](https://access.redhat.com/products/red-hat-enterprise-linux/evaluation) |
 | SUSE Linux Enterprise Server v15 (SP5 and later versions) | **XFS** or **ext4** | [Installation guide](../quickstart-install-connect-suse.md) | [Get SLES v15](https://www.suse.com/products/server) |
 | Ubuntu 22.04 | **XFS** or **ext4** | [Installation guide](../quickstart-install-connect-ubuntu.md) | [Get Ubuntu 22.04](https://releases.ubuntu.com/22.04/) |
-| Docker Engine 1.8+ on Linux | N/A | [Installation guide](../quickstart-install-connect-docker.md) | [Get Docker](https://www.docker.com/get-started) |
+| Docker Engine 1.8+ on Linux <sup>1</sup> | N/A | [Installation guide](../quickstart-install-connect-docker.md) | [Get Docker](https://www.docker.com/get-started) |
+
+<sup>1</sup> [!INCLUDE [container-emulation](container-emulation.md)]
 
 > [!TIP]  
 > For more information, review the [system requirements](../sql-server-linux-setup.md#system) for [!INCLUDE [ssnoversion-md](../../includes/ssnoversion-md.md)] on Linux. For the latest support policy for [!INCLUDE [ssNoVersion](../../includes/ssnoversion-md.md)], see the [Technical support policy for Microsoft SQL Server](/troubleshoot/sql/general/support-policy-sql-server).
diff --git a/docs/linux/quickstart-install-connect-docker.md b/docs/linux/quickstart-install-connect-docker.md
@@ -26,6 +26,9 @@ ms.custom:
 
 In this quickstart, you use Docker to pull and run the [!INCLUDE [sssql17-md](../includes/sssql17-md.md)] Linux container image, [mssql-server-linux](https://mcr.microsoft.com/product/mssql/server/about). Then you can connect with **sqlcmd** to create your first database and run queries.
 
+> [!NOTE]  
+> [!INCLUDE [container-emulation](includes/container-emulation.md)]
+
 For more information on supported platforms, see [Release notes for SQL Server 2017 on Linux](sql-server-linux-release-notes-2017.md).
 
 > [!WARNING]  
@@ -44,6 +47,9 @@ This quickstart creates [!INCLUDE [sssql17-md](../includes/sssql17-md.md)] conta
 
 In this quickstart, you use Docker to pull and run the [!INCLUDE [sssql19-md](../includes/sssql19-md.md)] Linux container image, [mssql-server-linux](https://mcr.microsoft.com/product/mssql/server/about). Then you can connect with **sqlcmd** to create your first database and run queries.
 
+> [!NOTE]  
+> [!INCLUDE [container-emulation](includes/container-emulation.md)]
+
 For more information on supported platforms, see [Release notes for SQL Server 2019 on Linux](sql-server-linux-release-notes-2019.md).
 
 > [!WARNING]  
@@ -62,6 +68,9 @@ This quickstart creates [!INCLUDE [sssql19-md](../includes/sssql19-md.md)] conta
 
 In this quickstart, you use Docker to pull and run the [!INCLUDE [sssql22-md](../includes/sssql22-md.md)] Linux container image, [mssql-server-linux](https://mcr.microsoft.com/product/mssql/server/about). Then you can connect with **sqlcmd** to create your first database and run queries.
 
+> [!NOTE]  
+> [!INCLUDE [container-emulation](includes/container-emulation.md)]
+
 For more information on supported platforms, see [Release notes for SQL Server 2022 on Linux](sql-server-linux-release-notes-2022.md).
 
 > [!WARNING]  
@@ -80,6 +89,9 @@ This quickstart creates [!INCLUDE [sssql22-md](../includes/sssql22-md.md)] conta
 
 In this quickstart, you use Docker to pull and run the [!INCLUDE [sssql25-md](../includes/sssql25-md.md)] Linux container image, [mssql-server-linux](https://mcr.microsoft.com/product/mssql/server/about). Then you can connect with **sqlcmd** to create your first database and run queries.
 
+> [!NOTE]  
+> [!INCLUDE [container-emulation](includes/container-emulation.md)]
+
 For more information on supported platforms, see [Release notes for SQL Server 2025 Preview on Linux](sql-server-linux-release-notes-2025.md).
 
 > [!WARNING]  
diff --git a/docs/linux/sql-server-linux-docker-container-deployment.md b/docs/linux/sql-server-linux-docker-container-deployment.md
@@ -22,14 +22,16 @@ ms.custom:
 
 This article explains how to deploy and connect to SQL Server Linux containers.
 
+> [!NOTE]  
+> [!INCLUDE [container-emulation](includes/container-emulation.md)]
+
 For other deployment scenarios, see:
 
 - [Windows](../database-engine/install-windows/install-sql-server.md)
 - [Linux](sql-server-linux-setup.md)
 - [Container cluster on Azure](quickstart-sql-server-containers-azure.md)
 
-> [!NOTE]  
-> This article specifically focuses on using the `mssql-server-linux` image. SQL Server deployments in Windows containers aren't covered by support. For development and testing, you can create your own custom container images to work with SQL Server in Windows containers. Sample files are available on [GitHub](https://github.com/microsoft/mssql-docker/blob/master/windows/mssql-server-windows-developer/dockerfile_1). Sample files are for reference only.
+This article specifically focuses on using the `mssql-server-linux` image. SQL Server deployments in Windows containers aren't covered by support. For development and testing, you can create your own custom container images to work with SQL Server in Windows containers. Sample files are available on [GitHub](https://github.com/microsoft/mssql-docker/blob/master/windows/mssql-server-windows-developer/dockerfile_1). Sample files are for reference only.
 
 > [!IMPORTANT]  
 > Before choosing to run a SQL Server container for production use cases, review the [Technical support policy for Microsoft SQL Server](/troubleshoot/sql/database-engine/install/windows/support-policy-sql-server) to ensure that you're running on a supported configuration.
