This topic describes how to install the Azure CLI 1.0, which is built on nodeJs and supports all classic deployment API calls as well as a large number of Resource Manager deployment activities. You should use the Azure CLI 2.0 for new or forward-looking CLI deployments and management.
Quickly install the Azure Command-Line Interface (Azure CLI 1.0) 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 1.0 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.
Option 1: Install an npm package
To install the CLI from an npm package, make sure you have downloaded and installed the latest Node.js and npm. Then, run npm install to install the azure-cli package:
npm install -g azure-cli
On Linux distributions, you might need to use sudo to successfully run the npm command, as follows:
sudo npm install -g azure-cli
If you need to install or update Node.js and npm on your Linux distribution or OS, 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>
Option 2: Use an installer
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.
Option 3: Use a Docker container
If you have set up your computer as a Docker host, you can run the latest Azure CLI 1.0 in a Docker container. Run the following command (on Linux distributions you might need to use sudo):
docker run -it microsoft/azure-cli
Run Azure CLI 1.0 commands
After the Azure CLI 1.0 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 1.0 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.
Update the CLI
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
Enable tab completion
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.