-->

For the macOS platform, you can install the Azure CLI with homebrew package manager. Homebrew makes it easy to keep yourinstallation of the CLI update to date. The CLI package has been tested on macOS versions 10.9 and later.

Bottom: Terminal offers a second way to control Mac OS X: a command line interface, which you operate by typing out programming commands. What the illustration at the bottom of Figure 15-1 shows, of course, is a command line interface: a place where you can type out instructions to the computer. An A-Z Index of the Apple macOS command line (macOS bash) afconvert Audio File Convert afinfo Audio File Info afplay Audio File Play airport Manage Apple AirPort alias Create an alias. alloc List used and free memory apropos Search the whatis database for strings asr Apple Software Restore atsutil Font registration system utility automator Run an Automator workflow awk Find and Replace text.

The current version of the Azure CLI is 2.18.0. For information about the latest release, see the release notes. To find your installed version and see if you need to update, run az version.

Install with Homebrew

Homebrew is the easiest way to manage your CLI install. It provides convenient ways to install, update, and uninstall.If you don't have homebrew available on your system, install homebrew before continuing.

You can install the CLI by updating your brew repository information, and then running the install command:

Important

The Azure CLI has a dependency on the Homebrew python3 package, and will install it.The Azure CLI is guaranteed to be compatible with the latest version of python3published on Homebrew.

You can then run the Azure CLI with the az command. To sign in, use az login command.

Run the login command.
If the CLI can open your default browser, it will do so and load an Azure sign-in page.
Otherwise, open a browser page at https://aka.ms/devicelogin and enter theauthorization code displayed in your terminal.
If no web browser is available or the web browser fails to open, use device code flow with az login --use-device-code.
Sign in with your account credentials in the browser.

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

Troubleshooting

If you encounter a problem when installing the CLI through Homebrew, here are some common errors. If you experience a problem not covered here, file an issue on github.

Completion is not working

The Homebrew formula of Azure CLI installs a completion file named az in the Homebrew-managed completions directory (default location is /usr/local/etc/bash_completion.d/). To enable completion, please follow Homebrew's instructions here.

Unable to find Python or installed packages

There may be a minor version mismatch or other issue during homebrew installation. The CLI doesn't use a Python virtual environment, so it relies on findingthe installed Python version. A possible fix is to install and relink the python3 dependency from Homebrew.

CLI version 1.x is installed

If an out-of-date version was installed, it could be because of a stale homebrew cache. Follow the update instructions.

Proxy blocks connection

You may be unable to get resources from Homebrew unless you have correctly configured it touse your proxy. Follow the Homebrew proxy configuration instructions.

Important

If you are behind a proxy, HTTP_PROXY and HTTPS_PROXY must be set to connect to Azure services with the CLI.If you are not using basic auth, it's recommended to export these variables in your .bashrc file.Always follow your business' security policies and the requirements of your system administrator.

In order to get the bottle resources from Homebrew, your proxy needs to allow HTTPS connections tothe following addresses:

https://formulae.brew.sh
https://homebrew.bintray.com

Update

The CLI is regularly updated with bug fixes, improvements, new features, and preview functionality. A new release is available roughly everythree weeks.

The CLI provides an in-tool command to update to the latest version:

Mac Os X Terminal Manual Transmission

Note

Mac Os X Terminal Manual User

The az upgrade command was added in version 2.11.0 and will not work with versions prior to 2.11.0.

This command will also update all installed extensions by default. For more az upgrade options, please refer to the command reference page.

You can also update your local Homebrew repository information and then upgrade the azure-cli package.

Uninstall

If you decide to uninstall the Azure CLI, we're sorry to see you go. Before you uninstall, use the az feedback command to let us knowwhat could be improved or fixed. Our goal is to make the Azure CLI bug-free and user-friendly. If you found a bug, we'd appreciate it if you file a GitHub issue.

Use homebrew to uninstall the azure-cli package.

Other installation methods

If you can't use homebrew to install the Azure CLI in your environment, it's possible to use the manual instructions for Linux. Note thatthis process is not officially maintained to be compatible with macOS. Using a package manager such as Homebrew is always recommended. Only use the manualinstallation method if you have no other option available.

For the manual installation instructions, see Install Azure CLI on Linux manually.

Next Steps

Now that you've installed the Azure CLI, take a short tour of its features and common commands.