Fixing the 'zsh: command not found: yarn' Error: Step-by-Step Guide to Resolve the Issue

This guide will walk you through the process of resolving the zsh: command not found: yarn error that you might encounter while using the Zsh shell. The error occurs when the Zsh shell cannot find the yarn command, which indicates that either Yarn is not installed or its path is not correctly set in the shell.

Table of Contents


Before proceeding, ensure you have the following installed on your system:

Step 1: Verify Yarn Installation

First, check whether Yarn is already installed on your system. Open your terminal and run the following command:

yarn --version

If Yarn is installed, you should see the version number displayed. If not, continue to the next step to install Yarn.

Step 2: Install Yarn (If Not Installed)

To install Yarn, you can use either of the following methods:

Method 1: Install Yarn using npm

Run the following command in your terminal to install Yarn globally using npm:

npm install --global yarn

Method 2: Install Yarn using Homebrew (macOS)

If you're on macOS and have Homebrew installed, you can use it to install Yarn:

brew install yarn

Now that Yarn is installed, proceed to the next step to add Yarn to the PATH.

Step 3: Add Yarn to PATH

To add Yarn to the PATH, you need to modify the Zsh configuration file (~/.zshrc). Follow these steps:

Open the ~/.zshrc file using your preferred text editor. For example, you can use the nano editor:

nano ~/.zshrc

Add the following line to the end of the file:

export PATH="$PATH:$(yarn global bin)"

Save the changes and close the file. If you're using nano, press CTRL + X, then Y, and finally, Enter.

Restart your terminal or run the following command to apply the changes:

source ~/.zshrc

Now, when you run the yarn command in your terminal, the zsh: command not found: yarn error should be resolved.

Frequently Asked Questions (FAQ)

How do I check if Zsh is installed on my system?

Run the following command in your terminal:

zsh --version

If Zsh is installed, you should see the version number displayed.

How do I change my default shell to Zsh?

Run the following command in your terminal:

chsh -s $(which zsh)

This will change your default shell to Zsh. Restart your terminal to apply the changes.

What is the difference between Yarn and npm?

Yarn and npm are both package managers for JavaScript and Node.js. Yarn was introduced to address some of the shortcomings of npm, such as performance and security issues. Yarn features a deterministic dependency resolution, which ensures that the same dependencies are installed across different systems. It also utilizes a cache mechanism to enable faster installation of packages.

Can I use both Yarn and npm in a project?

Although it's possible to use both Yarn and npm in a project, it's not recommended due to potential conflicts and inconsistencies in the dependency management. It's best to stick to one package manager per project.

How do I uninstall Yarn?

To uninstall Yarn, you can follow the installation method you used:

If you installed Yarn using npm:

npm uninstall --global yarn

If you installed Yarn using Homebrew (macOS):

brew uninstall yarn

After uninstalling Yarn, don't forget to remove the Yarn path from your ~/.zshrc file.

Great! You’ve successfully signed up.

Welcome back! You've successfully signed in.

You've successfully subscribed to

Success! Check your email for magic link to sign-in.

Success! Your billing info has been updated.

Your billing was not updated.