Install the Azure CLI
Quickly install the Azure Command-Line Interface (Azure CLI) to use a set of open-source shell-based commands for creating and managing resources in Microsoft Azure. You have several options to install these cross-platform tools on your computer:
- Installer - Download an installer for easy installation on Mac or Windows.
- Docker container - Start using the latest CLI in a ready-to-run Docker container. Requires Docker host on your computer.
For more options and background, see the project repository on GitHub.
Once the Azure CLI is installed, connect it with your Azure subscription and run the azure commands from your command-line interface (Bash, Terminal, Command prompt, and so on) to work with your Azure resources.
To install the CLI from an npm package, you need the latest Node.js and npm installed on your system. Then, run the following command to install the Azure CLI package published at npmjs.com. (On Linux distributions, you might need to use sudo to successfully run the npm command.)
npm install -g azure-cli
If you need to install or update Node.js and npm on your Linux distribution or OS, see the documentation at Nodejs.org. We recommend that you install the most recent Node.js LTS version (4.x). If you use an older version, you might get installation errors.
If you prefer, download the latest Linux tar file for the npm package locally. Then, install the downloaded npm package as follows (on Linux distributions you might need to use sudo):
npm install -g <path to downloaded tar file>
If you use a Mac or Windows computer, the following CLI installers are available for download:
On Windows, you can also download the Web Platform Installer to install the CLI. This installer gives you the option to install additional Azure SDK and command-line tools after installing the CLI.
If you have set up your computer as a Docker host, you can run the latest Azure CLI in a Docker container. Run:
docker run -it microsoft/azure-cli
After the Azure CLI is installed, run the azure command from your command-line user interface (Bash, Terminal, Command prompt, and so on). For example, to run the help command, type the following:
On some Linux distributions, you may receive an error similar to
/usr/bin/env: ‘node’: No such file or directory. This error comes from recent installations of Node.js being installed at /usr/bin/nodejs. To fix it, create a symbolic link to /usr/bin/node by running this command:
sudo ln -s /usr/bin/nodejs /usr/bin/node
To see the version of the Azure CLI you installed, type the following:
Now you are ready! To access all the CLI commands to work with your own resources, connect to your Azure subscription from the Azure CLI.
When you first use Azure CLI, you see a message asking if you want to allow Microsoft to collect usage information. Participation is voluntary. If you choose to participate, you can stop at any time by running
azure telemetry --disable. To enable participation at any time, run
azure telemetry --enable.
Microsoft frequently releases updated versions of the Azure CLI. Reinstall the CLI using the installer for your operating system, or run the latest Docker container. Or, if you have the latest Node.js and npm installed, update by typing the following (on Linux distributions you might need to use sudo).
npm update -g azure-cli
Tab completion of CLI commands is supported for Mac and Linux.
To enable it in zsh, run:
echo '. <(azure --completion)' >> .zshrc
To enable it in bash, run:
azure --completion >> ~/azure.completion.sh echo 'source ~/azure.completion.sh' >> ~/.bash_profile
Connect from the CLI to your Azure subscription to create and manage Azure resources.
To learn more about the Azure CLI, download source code, report problems, or contribute to the project, visit the GitHub repository for the Azure CLI.
If you have questions about using the Azure CLI, or Azure, visit the Azure Forums.
For Linux systems, you can also install the Azure CLI by building it from the source. For more information on building from source, see the INSTALL file included in the source archive.