Install Shopify App CLI
This guide shows you how to install Shopify App CLI on Windows, macOS, or Linux. You can use your computer's command line to install the CLI from one of the supported package managers.
Requirements
To use Shopify App CLI, you need to have the following:
- A Shopify partner account
- A Shopify development store to install and test apps
- Ruby 2.7 or higher installed on your computer
Install on Windows
If you want to use Shopify App CLI natively on Windows 10, then we recommend installing Ruby using RubyInstaller for Windows.
Alternatively, you can also use Shopify App CLI using Windows Subsystem for Linux, in which case you need:
On Windows, install Shopify App CLI as a Ruby gem using the RubyGems.org package manager:
- Open your terminal app.
- Run
gem install shopify-cli
. - After the installation has completed, run
shopify version
to verify the installation was successful.
Install on macOS
Shopify App CLI is available for MacOS through either RubyGems.org or Homebrew.
Install with RubyGems.org
- Open your terminal app.
- Run
gem install shopify-cli
. - After the installation has completed, run
shopify version
to verify the installation was successful.
Install with Homebrew
- Open your terminal app.
- Run
brew tap shopify/shopify
to add Shopify’s third-party repositories to Homebrew. - Run
brew install shopify-cli
. - After the installation has completed, run
shopify version
to verify the installation was successful.
Install on Linux
Shopify App CLI is available for Linux distributions through RubyGems.org, as well as through apt or yum.
Install with RubyGems.org
- Open your terminal app.
- Run
gem install shopify-cli
. - After the installation has completed, run
shopify version
to verify the installation was successful.
Install with apt (Debian, Ubuntu)
On Debian-based Linux systems, Shopify App CLI is available to install with apt
.
- Download the latest Shopify App CLI
.deb
file from the releases page on GitHub. Note the file’s location for the next step. - Open your terminal app.
- Run
sudo apt install /path/to/download/shopify-cli-x.y.z.deb
. Make sure to replace/path/to/download/shopify-cli-x.y.z.deb
with the path to your file's location. - After the installation has completed, run
shopify version
to verify the installation was successful.
Install with yum (CentOS 8+, Fedora, Red Hat, SUSE Linux)
On RPM-based Linux systems, Shopify App CLI is available to install with yum
.
- Download the latest Shopify App CLI
.rpm
file from the releases page on GitHub. Note the file’s location for the next step. - Open your terminal app.
- Run
sudo apt install /path/to/download/shopify-cli-x.y.z.rpm
. Make sure to replace/path/to/download/shopify-cli-x.y.z.rpm
with the path to your file's location. - After the installation has completed, run
shopify version
to verify the installation was successful.
Next steps
- Learn how to create and manage different types of projects with Shopify App CLI.
- Familiarize yourself with the core commands for Shopify App CLI.
- Troubleshoot common issues, including upgrading, migrating from a legacy version, and uninstalling Shopify App CLI.