Quickstart for Bash in Azure Cloud Shell

This document details how to use Bash in Azure Cloud Shell in the Azure portal.


A PowerShell in Azure Cloud Shell Quickstart is also available.

Start Cloud Shell

  1. Launch Cloud Shell from the top navigation of the Azure portal.

    Screenshot showing how to start Azure Cloud Shell in the Azure portal.

  2. Select a subscription to create a storage account and Microsoft Azure Files share.

  3. Select "Create storage"


You are automatically authenticated for Azure CLI in every session.

Select the Bash environment

Check that the environment drop-down from the left-hand side of shell window says Bash.

Screenshot showing how to select the Bash environment for the Azure Cloud Shell.

Set your subscription

  1. List subscriptions you have access to.

    az account list
  2. Set your preferred subscription:

    az account set --subscription 'my-subscription-name'


Your subscription is remembered for future sessions using /home/<user>/.azure/azureProfile.json.

Create a resource group

Create a new resource group in WestUS named "MyRG".

az group create --location westus --name MyRG

Create a Linux VM

Create an Ubuntu VM in your new resource group. The Azure CLI will create SSH keys and set up the VM with them.

az vm create -n myVM -g MyRG --image UbuntuLTS --generate-ssh-keys


Using --generate-ssh-keys instructs Azure CLI to create and set up public and private keys in your VM and $Home directory. By default keys are placed in Cloud Shell at /home/<user>/.ssh/id_rsa and /home/<user>/.ssh/id_rsa.pub. Your .ssh folder is persisted in your attached file share's 5-GB image used to persist $Home.

Your username on this VM will be your username used in Cloud Shell ($User@Azure:).

SSH into your Linux VM

  1. Search for your VM name in the Azure portal search bar.

  2. Select Connect to get your VM name and public IP address.

    Screenshot showing how to connect to a Linux VM using SSH.

  3. SSH into your VM with the ssh cmd.

    ssh username@ipaddress

Upon establishing the SSH connection, you should see the Ubuntu welcome prompt.

Screenshot showing the Ubuntu initialization and welcome prompt after you establish an SSH connection.

Cleaning up

  1. Exit your ssh session.

  2. Delete your resource group and any resources within it.

    az group delete -n MyRG

Next steps