Run Azure CLI 2.0 in a Docker container

You can use Docker to run a standalone Linux container with the Azure CLI 2.0 pre-installed. Docker lets you get started quickly with an environment where you can try out the CLI to decide if it's right for you, or use our image as a base for your own deployment.

Run in a Docker container

Install the CLI using docker run.

docker run -it microsoft/azure-cli


If you want to pick up the SSH keys from your user environment, you can use -v ${HOME}/.ssh:/root/.ssh to mount your SSH keys in the environment.

docker run -it -v ${HOME}/.ssh:/root/.ssh microsoft/azure-cli

The CLI is installed on the image as the az command in /usr/local/bin. To sign in, run the az login command.

  1. Run the login command.

    az login

    If the CLI can determine your default browser and has access to open it, it will do so and direct you immediately to a sign in page.

    Otherwise, you need to open a browser page and follow the instructions on the command line to enter an authorization code after navigating to in your browser.

  2. Sign in with your account credentials in the browser.

To learn more about different authentication methods, see Sign in with Azure CLI 2.0.

Update Docker image

Updating with Docker requires both pulling the new image and re-creating any existing containers. For this reason you should try to avoid using a container that hosts the CLI as a data store.

Update your local image with docker pull.

docker pull microsoft/azure-cli

Uninstall Docker image

If you decide to uninstall the Azure CLI, we're sorry to see you go. Before you uninstall, use the az feedback command to give some information about why you chose to uninstall and how the CLI could be improved. Our goal is to make the Azure CLI bug-free and user-friendly. If you encountered a bug, we'd appreciate it if you file a GitHub issue.

After halting any containers running the CLI image, remove it.

docker rmi microsoft/azure-cli