Installation and upgrade

Shopify recommends a global Shopify CLI installation for a single upgrade point across app, theme, and Hydrogen work. Since CLI 3.59, app, theme, and Hydrogen commands are unified under the @shopify/cli package.

Install globally with pnpm

pnpm install -g @shopify/cli@latest

Other official install options are npm, Yarn, and Homebrew, but this project uses pnpm by default.

Verify the install

shopify version
shopify help
shopify commands --tree

Upgrade

shopify version
pnpm install -g @shopify/cli@latest

Proxy configuration

Shopify CLI 3.78+ can route traffic through a proxy:

export SHOPIFY_HTTP_PROXY=http://proxy.com:8080
export SHOPIFY_HTTPS_PROXY=https://secure-proxy.com:8443

Authenticated proxy example:

export SHOPIFY_HTTP_PROXY=http://username:password@proxy.com:8080

Usage analytics

Anonymous usage statistics are collected by default. Opt out with:

export SHOPIFY_CLI_NO_ANALYTICS=1

The latest generated docs also mention OPT_OUT_INSTRUMENTATION=true.