Install Shopify CLI

This guide shows you how to install Shopify CLI on macOS, Windows, or Linux.

Requirements

The requirements to install and run Shopify CLI depend on your operating system:

Operating system Requirements

macOS

Operating system	Requirements
macOS	Homebrew Node.js 18 or higher. Ruby Git Note: When you install Shopify CLI using Homebrew, Homebrew installs Node.js, Ruby, and Git for you.
Windows	Node.js 18 or higher. Ruby+Devkit 3.0, installed using RubyInstaller for Windows (select the MSYS2 component and the MSYS2 base installation option) Git Bundler 2.3.8 or higher
Linux	Node.js 18 or higher. Ruby 3.0 Ruby development environment (`ruby-dev` / `ruby-devel`) Git cURL GCC g++ Make

Note: When you install Shopify CLI using Homebrew, Homebrew installs Node.js, Ruby, and Git for you.

Windows

Node.js 18 or higher.
Ruby+Devkit 3.0, installed using RubyInstaller for Windows
(select the MSYS2 component and the MSYS2 base installation option)
Git
Bundler 2.3.8 or higher

Linux

Use the following commands to install all of the requirements to install and run Shopify CLI on Linux, other than Node.js:

Shopify CLI is managed as a set of Node.js packages:

You can install these packages using Homebrew on macOS, or by installing the packages globally on Windows or Linux.

You can install Shopify CLI on macOS using Homebrew.

You need to add Shopify's third-party repositories to Homebrew using brew tap before you can install Shopify CLI.

To install Shopify CLI for themes, install the @shopify/cli and @shopify/theme Node.js packages globally using the command line.

To verify that Shopify CLI is installed properly, run the following command:

The command returns a version number.