Skip to content

installation.md

Latest commit

 

History

History
57 lines (40 loc) · 1.2 KB

installation.md

File metadata and controls

57 lines (40 loc) · 1.2 KB

Installation

Quick install (recommended)

# macOS / Linux
curl -sSL https://aka.ms/apm-unix | sh

# Windows (PowerShell)
irm https://aka.ms/apm-windows | iex

Package managers

# Homebrew (macOS / Linux)
brew install microsoft/apm/apm

# Scoop (Windows)
scoop bucket add apm https://github.com/microsoft/scoop-apm
scoop install apm

# pip (all platforms, requires Python 3.10+)
pip install apm-cli

Verify

apm --version

Update

apm update          # update APM itself
apm update --check  # check for updates without installing

Installer options (macOS / Linux)

# Specific version
curl -sSL https://aka.ms/apm-unix | sh -s -- @v1.2.3

# Custom install dir
curl -sSL https://aka.ms/apm-unix | APM_INSTALL_DIR=$HOME/.local/bin sh

# Air-gapped / GHE mirror (skips GitHub API when VERSION is set)
GITHUB_URL=https://github.corp.com VERSION=v1.2.3 sh install.sh

Troubleshooting

  • macOS/Linux "command not found": ensure your install directory (default /usr/local/bin) is in $PATH.
  • Permission denied: use APM_INSTALL_DIR=$HOME/.local/bin to install without sudo.
  • Windows antivirus locks: set $env:APM_DEBUG = "1" and retry.