How to Install Yarn: A Complete Step-by-Step Guide

What Yarn is and why you should install it

Yarn is a package manager for JavaScript projects that helps you track dependencies, run scripts, and work with multiple packages in a single repository. The Install Manual team highlights its reliable, deterministic installs and efficient caching, which can speed up development workflows. If you’ve used npm before, you’ll notice Yarn often resolves dependencies faster and creates a more predictable install experience across machines. Yarn is available in two major lines: Yarn 1 (classic) and Yarn 2+ (Berry), each with different defaults and plugin ecosystems. For most new projects, Yarn Berry’s modern features—like workspaces and zero-install workflows—offer real productivity gains, but you can choose the version that fits your team’s needs. This guide focuses on how to install Yarn correctly on macOS, Windows, and Linux, what to verify after installation, and how to troubleshoot common issues. By installing Yarn, you gain access to consistent dependency resolution, offline caching, and streamlined workspace management that can simplify monorepos and large projects. Whether you’re a homeowner tackling a personal project or a developer contributing to a shared repository, following these steps will put Yarn in your toolkit with confidence.

Prerequisites and environment checks

Before starting, verify you have a supported environment. You’ll typically need Node.js and npm present to access the registry and run scripts. Check that your system PATH includes the directories where Node.js and npm install binaries; this ensures that yarn commands are accessible from any terminal. If you’re on macOS or Linux, you may already have npm installed via your package manager; Windows users can verify by opening PowerShell and running node -v and npm -v. Ensure you have an active internet connection for downloading the binaries and registry data. Finally, decide which installation method you’ll use (npm, Homebrew, or platform-specific installers) and prepare any platform-specific prerequisites, such as Homebrew on macOS or Chocolatey on Windows. The goal of this step is to confirm you can run command-line tools and install software on your machine.

Installation methods by platform: an overview

There isn’t a single universal installer for Yarn; instead, you can choose one of several reliable paths depending on your operating system and preferences. The most common methods are: using npm to install Yarn globally, using a macOS package manager like Homebrew, or using a Windows package manager like Chocolatey. Linux users can install Yarn via their distro’s package manager (apt, dnf, or pacman) or via npm if preferred. Each method results in a usable Yarn binary and a path that your shell can access. We’ll cover each approach briefly in this section, then dive into step-by-step instructions for the platform-specific methods in the next section. If you already have Node.js installed, the npm method becomes particularly convenient because Yarn can be installed with a single command; vice versa, using corepack is another modern option when your Node environment supports it. Remember to verify the installation after completing any method.

Installing Yarn on macOS, Windows, and Linux: step-by-step by platform

• macOS (Homebrew): If you use Homebrew, installing Yarn is straightforward. First, ensure Homebrew is up to date with brew update. Then run brew install yarn. If you want to avoid installing Node with Homebrew, you can install Yarn with the --ignore-dependencies flag or use corepack to manage Yarn versions. After installation, run yarn -v to confirm the version and path.
• Windows (Chocolatey): With Chocolatey, open an elevated PowerShell session and run choco install yarn. This method places Yarn’s binaries on your system path. After installation, restart your terminal and run yarn -v. If you encounter permission prompts, ensure you opened PowerShell as Administrator.
• Linux (apt/dnf/pacman): On Debian/Ubuntu, you can set up the official Yarn repository or install via npm. For Red Hat-based distributions, use dnf or yum with the Yarn repository. After installing, verify with yarn -v and test a simple command like yarn init to ensure it works as expected. The Linux instructions assume you have a functioning package manager and network access.