Install, upgrade, or uninstall Shopify CLI 2.x
This reference guide contains information about upgrading Shopify CLI, migrating from a legacy version, and uninstalling Shopify CLI.
This documentation is for the previous major version of Shopify CLI. Unless specifically instructed, you should use the new version of Shopify CLI (version 3), which provides a more streamlined theme development experience. Shopify CLI 2.x is deprecated, and no longer supported by Shopify. Learn how to migrate to Shopify CLI 3.x.
Anchor to Install Shopify CLI 2.xInstall Shopify CLI 2.
If you need to, you can install Shopify CLI 2.x. You can install Shopify CLI 2.x on Windows, macOS, or Linux. Use your computer's command line to install Shopify CLI from one of the supported package managers.
Anchor to RequirementsRequirements
To install and run Shopify CLI, you need to have the following installed on your computer:
- Ruby or Ruby+Devkit using RubyInstaller for Windows
2.7 or higher
- Git
Anchor to WindowsWindows
Anchor to MacOSMac
Shopify CLI is available for macOS through RubyGems.org.
In a new terminal window, navigate to your home directory and run the following command:
Anchor to LinuxLinux
Anchor to Verify the installationVerify the installation
To verify that Shopify CLI 2.x is installed properly, run the following command:
The command returns a version number.
Anchor to Upgrade Shopify CLIUpgrade Shopify CLI
Anchor to Migrate from a legacy versionMigrate from a legacy version
Anchor to Uninstall Shopify CLIUninstall Shopify CLI
Shopify CLI can be removed from your system using the same package manager that you used to install it.
Anchor to Homebrew (macOS)Homebrew (mac
Anchor to apt (Debian, Ubuntu)apt (Debian, Ubuntu)
Anchor to yum (CentOS 8+, Fedora, Red Hat, SUSE)yum (Cent
Anchor to Uninstall a legacy versionUninstall a legacy version
If you’re using a legacy version of Shopify CLI (lower than 0.9.0), then you need to uninstall it manually.
Anchor to Next stepsNext steps
- Review the commands for Shopify CLI.