Install Shopify App CLI
Shopify App CLI can be installed on a variety of systems, using a variety of package managers.
Note that for systems that have multiple installation options, you only need to use one of these methods to install.
macOS
Shopify App CLI is available through Homebrew or RubyGems.
Homebrew
You’ll need to run brew tap
first to add Shopify’s third-party repositories to Homebrew.
$ brew tap shopify/shopify
$ brew install shopify-cli
RubyGems
See the RubyGems section for further details.
Debian/Ubuntu Linux
On Debian-based Linux systems, Shopify App CLI is available through the apt
command or RubyGems.
apt
You’ll need to install a downloaded .deb
file with an explicit version number. Check the releases page to make sure you install the latest package.
- Download the
.deb
file from the releases page - Install the downloaded file
$ sudo apt install /path/to/downloaded/shopify-cli-x.y.z.deb
RubyGems
See the RubyGems section for further details.
CentOS 8+/Fedora/Red Hat/SUSE Linux
On RPM-based Linux systems, Shopify App CLI is available through the yum
command or RubyGems.
yum
You’ll need to install a downloaded .rpm
file with an explicit version number. Check the releases page to make sure you install the latest package.
- Download the
.rpm
file from the releases page - Install the downloaded file
$ sudo yum install /path/to/downloaded/shopify-cli-x.y.x.rpm
RubyGems
See the RubyGems section for further details.
Windows 10
On Windows 10 systems, Shopify App CLI is available through RubyGems.
RubyGems (all platforms)
Shopify App CLI is available on all platforms as a RubyGem through RubyGems.org.
$ gem install shopify-cli
To check that Shopify App CLI is installed correctly:
$ shopify version
1.0.0
$
Note 1: the version displayed may be newer.
Note 2: If you have the
shopify_api
gem installed, you may see the following response:shopify command is no longer bundled with shopify_api. if you need these tools, install the shopify_cli gem
If so, then you will also need to upgrade the
shopify_api
gem to v9.2.0+ to remove a deprecatedshopify
command that is contained in that gem.If you also have the
shopify_app
gem (which depends onshopify_api
gem), you’ll need to install or updateshopify_api
first, then uninstall the older version.To get a list of the version(s) of
shopify_api
currently installed:$ gem list shopify_api
To install the latest version:
$ gem install shopify_api
To uninstall the older version:
$ gem uninstall shopify_api -v x.y.z
Replace x.y.z with a version number listed from the
gem list
command. Repeat as needed.