Refresh article

Author: cdpark

articles/app-service/configure-linux-open-ssh-session.md

@@ -1,12 +1,12 @@
 ---
 title: SSH Access for Linux and Windows Containers
-description: You can open an SSH session to a Linux or a Windows container in Azure App Service. Custom Linux containers are supported with some modifications to your custom image.  Custom Windows containers require no modifications to your custom image.
+description: Learn how to open an SSH session to a Linux or a Windows container in Azure App Service. Custom Linux containers are supported with some modifications to your custom image.
 keywords: azure app service, web app, linux, windows, oss
 author: msangapu-msft
 
 ms.assetid: 66f9988f-8ffa-414a-9137-3a9b15a5573c
 ms.topic: how-to
-ms.date: 01/28/2025
+ms.date: 02/12/2026
 ms.author: msangapu
 ms.custom: devx-track-azurecli, linux-related-content
 zone_pivot_groups: app-service-containers-windows-linux
@@ -21,21 +21,29 @@ ms.service: azure-app-service
 
 [Secure Shell (SSH)](https://wikipedia.org/wiki/Secure_Shell) can be used to execute administrative commands remotely to a container. App Service provides SSH support directly into an app hosted in a Windows custom container. 
 
-Windows custom containers don't require any special settings for the [browser SSH session](#open-ssh-session-in-browser) to work. SSH sessions through Azure CLI are not supported.
-
-![Linux App Service SSH](./media/configure-linux-open-ssh-session/app-service-linux-ssh.png)
+Windows custom containers don't require any special settings for the [browser SSH session](#open-ssh-session-in-browser) to work.
 
 ::: zone-end
 
 ::: zone pivot="container-linux"
 
 [Secure Shell (SSH)](https://wikipedia.org/wiki/Secure_Shell) can be used to execute administrative commands remotely to a container. App Service provides SSH support directly into an app hosted in a Linux container (built-in or custom). 
 
-The built-in Linux containers already have the necessary configuration to enable SSH sessions. Linux custom containers require additional configurations to enable SSH sessions. See [Enable SSH](configure-custom-container.md?pivots=container-linux#enable-ssh).
+The built-in Linux containers already have the necessary configuration to enable SSH sessions. Linux custom containers require additional configurations to enable SSH sessions. To learn more, see [Enable SSH](configure-custom-container.md?pivots=container-linux#enable-ssh).
+
+::: zone-end
+
+:::image type="content" source="./media/configure-linux-open-ssh-session/app-service-ssh.png" alt-text="Screenshot that shows the App Service SSH.":::
+
+::: zone pivot="container-windows"
+
+SSH sessions through the Azure CLI aren't supported for Windows App Service plans. Only Linux App Service plans are supported.
 
-![Linux App Service SSH](./media/configure-linux-open-ssh-session/app-service-linux-ssh.png)
+::: zone-end
+
+::: zone pivot="container-linux"
 
-You can also connect to the container directly from your local development machine using SSH and SFTP.
+You can also connect to the container directly from your local development machine by using SSH and SFTP.
 
 ::: zone-end
 
@@ -45,23 +53,23 @@ You can also connect to the container directly from your local development machi
 
 ::: zone pivot="container-linux"
 
-## Open SSH session with Azure CLI
+## Open SSH session with the Azure CLI
 
-Using TCP tunneling you can create a network connection between your development machine and Linux containers over an authenticated WebSocket connection. It enables you to open an SSH session with your container running in App Service from the client of your choice.
+By using TCP tunneling, you can create a network connection between your development machine and Linux containers over an authenticated WebSocket connection. You can then open an SSH session with your container running in App Service from the client of your choice.
 
-To get started, you need to install [Azure CLI](/cli/azure/install-azure-cli). To see how it works without installing Azure CLI, open [Azure Cloud Shell](../cloud-shell/overview.md).
+To get started, you need to install the [Azure CLI](/cli/azure/install-azure-cli). To see how it works without installing the Azure CLI, open [Azure Cloud Shell](../cloud-shell/overview.md).
 
-Open a remote connection to your app using the [az webapp create-remote-connection](/cli/azure/webapp#az-webapp-create-remote-connection) command. Specify _\<subscription-id>_, _\<group-name>_ and _\<app-name>_ for your app.
+Open a remote connection to your app by using the [az webapp create-remote-connection](/cli/azure/webapp#az-webapp-create-remote-connection) command. Specify _\<subscription-id>_, _\<resource-group-name>_, and _\<app-name>_ for your app.
 
 ```azurecli-interactive
 az webapp create-remote-connection --subscription <subscription-id> --resource-group <resource-group-name> -n <app-name> &
 ```
 
 > [!TIP]
-> `&` at the end of the command is just for convenience if you are using Cloud Shell. It runs the process in the background so that you can run the next command in the same shell.
+> `&` at the end of the command is just for convenience if you're using Cloud Shell. It runs the process in the background so that you can run the next command in the same shell.
 
 > [!NOTE]
-> If this command fails, make sure [remote debugging](https://medium.com/@auchenberg/introducing-remote-debugging-of-node-js-apps-on-azure-app-service-from-vs-code-in-public-preview-9b8d83a6e1f0) is *disabled* with the following command:
+> If this command fails, make sure [remote debugging](https://medium.com/@auchenberg/introducing-remote-debugging-of-node-js-apps-on-azure-app-service-from-vs-code-in-public-preview-9b8d83a6e1f0) is *disabled* by using the following command:
 >
 > ```azurecli-interactive
 > az webapp config set --resource-group <resource-group-name> -n <app-name> --remote-debugging-enabled=false
@@ -78,26 +86,26 @@ SSH is available { username: root, password: Docker! }
 Ctrl + C to close
 ```
 
-Open an SSH session with your container with the client of your choice, using the local port provided in the output (`<port-output>`). For example, with the linux [ssh](https://ss64.com/bash/ssh.html) command, you can run a single command like `java -version`:
+Open an SSH session with your container using the client of your choice, through the local port provided in the output (`<port-output>`). For example, with the Linux [ssh](https://ss64.com/bash/ssh.html) command, you can run a single command like `java -version`:
 
 ```bash
 ssh [email protected] -m hmac-sha1 -p <port-output> java -version
 ```
      
-Or, to enter a full SSH session, just run:
+Or, to enter a full SSH session, run:
 
 ```bash
 ssh [email protected] -m hmac-sha1 -p <port-output>
 ```
 
-When being prompted, type `yes` to continue connecting. You are then prompted for the password. Use `Docker!`, which was shown to you earlier.
+When prompted, type `yes` to continue connecting. You're then prompted for the password. Use `Docker!`, which was shown to you earlier.
 
 <pre>
 Warning: Permanently added '[127.0.0.1]:21382' (ECDSA) to the list of known hosts.
 [email protected]'s password:
 </pre>
 
-Once you're authenticated, you should see the session welcome screen.
+After you're authenticated, you should see the session welcome screen.
 
 <pre>
   _____
@@ -111,9 +119,9 @@ A P P   S E R V I C E   O N   L I N U X
 0e690efa93e2:~#
 </pre>
 
-You are now connected to your connector.  
+You're now connected to your connector.  
 
-Try running the [top](https://ss64.com/bash/top.html) command. You should be able to see your app's process in the process list. In the example output below, it's the one with `PID 263`.
+Try running the [top](https://ss64.com/bash/top.html) command. You should be able to see your app's process in the process list. In the example output, it's the one with `PID 263`.
 
 <pre>
 Mem: 1578756K used, 127032K free, 8744K shrd, 201592K buff, 341348K cached
@@ -143,8 +151,8 @@ Load average: 0.07 0.04 0.08 4/765 45738
 
 You can post questions and concerns on the [Azure forum](/answers/tags/436/azure-app-service).
 
-For more information on Web App for Containers, see:
+To learn more about App Service for containers, see:
 
 * [Introducing remote debugging of Node.js apps on Azure App Service from VS Code](https://medium.com/@auchenberg/introducing-remote-debugging-of-node-js-apps-on-azure-app-service-from-vs-code-in-public-preview-9b8d83a6e1f0)
 * [Quickstart: Run a custom container on App Service](quickstart-custom-container.md?pivots=container-linux)
-* [Azure App Service Web App for Containers FAQ](faq-app-service-linux.yml)
+* [Azure App Service on Linux FAQ](faq-app-service-linux.yml)