Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Most users should use the one-command installer. Use this guide for offline installs, as a fallback when the installer or its download fails, when you already have the archive, or to understand the steps the installer performs. Neither method requires the GitHub CLI or GitHub sign-in.
Get from a downloaded azcli archive to a working az command: pick the file for your OS and CPU, extract it, and run az from that folder. Adding it to PATH is optional and manual.
Pick your download
Download the archive from the public GitHub Releases page. For an offline machine, download it on a connected machine and transfer the archive.
First choose a package type:
| Package | File name starts with | Use when |
|---|---|---|
| Lean | azcli-lean |
Smallest package; built-in extensions only. Add more later from the extensions bundle. |
| Full | azcli |
CLI plus the add-on extensions bundled in the archive. |
Then choose the archive for your machine and package type:
Use the linux-musl archives on musl-based distributions such as Alpine Linux. Use the standard linux archives on glibc-based distributions such as Ubuntu, Debian, Fedora, and Azure Linux.
| Your machine | Lean package | Full package |
|---|---|---|
| Windows on Intel/AMD 64-bit | azcli-lean-<version>-win-x64.zip |
azcli-<version>-win-x64.zip |
| Windows on Arm64 | azcli-lean-<version>-win-arm64.zip |
azcli-<version>-win-arm64.zip |
| Linux with glibc on Intel/AMD 64-bit | azcli-lean-<version>-linux-x64.tar.gz |
azcli-<version>-linux-x64.tar.gz |
| Linux with glibc on Arm64 | azcli-lean-<version>-linux-arm64.tar.gz |
azcli-<version>-linux-arm64.tar.gz |
| Linux with musl on Intel/AMD 64-bit | azcli-lean-<version>-linux-musl-x64.tar.gz |
azcli-<version>-linux-musl-x64.tar.gz |
| Linux with musl on Arm64 | azcli-lean-<version>-linux-musl-arm64.tar.gz |
azcli-<version>-linux-musl-arm64.tar.gz |
| macOS on Intel | azcli-lean-<version>-macos-x86_64.tar.gz |
azcli-<version>-macos-x86_64.tar.gz |
| macOS on Apple Silicon | azcli-lean-<version>-macos-arm64.tar.gz |
azcli-<version>-macos-arm64.tar.gz |
Both packages are self-contained — you do not need the .NET SDK to run them.
Extract and run
Extract the archive anywhere you like, then run az straight from that folder — the CLI is self-contained. Replace <version> and the platform suffix with your downloaded file.
Linux / macOS / WSL (.tar.gz):
mkdir -p ~/.local/share/azcli
tar -xzf ./azcli-<version>-linux-x64.tar.gz -C ~/.local/share/azcli
chmod +x ~/.local/share/azcli/az
~/.local/share/azcli/az --help
Windows (.zip):
Expand-Archive -Path ".\azcli-<version>-win-x64.zip" -DestinationPath "$env:LOCALAPPDATA\Programs\azcli" -Force
& "$env:LOCALAPPDATA\Programs\azcli\az.exe" --help
On macOS, if the binary is blocked after download, validate the source, then run xattr -dr com.apple.quarantine ~/.local/share/azcli.
Adding az to PATH (optional, manual)
The archive is not registered on your PATH, so az isn't found automatically — run it by full path, or add its folder to PATH yourself. For the current shell only:
export PATH="$HOME/.local/share/azcli:$PATH" # Linux / macOS / WSL
$env:Path = "$env:LOCALAPPDATA\Programs\azcli;$env:Path" # Windows
To make it permanent, add that line to your shell profile (~/.zshrc / ~/.bashrc, or your PowerShell $PROFILE). Putting azcli on PATH makes az resolve to it and shadows the classic azure-cli.
Verify
| Check | Command |
|---|---|
| CLI starts | az --help |
| Extensions visible | az extension list |
Commands that contact Azure require sign-in and a subscription. If az is found but asks you to authenticate, the install itself is working.
Troubleshooting
| Symptom | Fix |
|---|---|
| Installer release lookup returns HTTP 403 or 429 | Check GitHub's response and retry after the API rate limit resets, or download the archive from GitHub Releases and extract it using this guide. |
az is not found |
Run az by its full path, or add its folder to PATH. For more information, see Adding az to PATH. |
| Permission denied (Linux/macOS) | Run chmod +x <install-root>/az. |
| macOS blocks the binary | Validate the source, then xattr -dr com.apple.quarantine <install-root>. |
| File name doesn't match examples | Use the platform suffix from your downloaded file (e.g. linux-arm64, win-arm64). |
| A command says an extension is missing | On lean installs, add the extension from the extensions bundle or use the full package. For more information, see Install Azure CLI preview extensions. |