Skip to main content

Installation Overview

Yazi can be installed through many package managers across all major platforms. Optional dependencies like ffmpeg, 7zip, poppler, fd, ripgrep, fzf, and zoxide unlock additional features but are not required to run Yazi.

Start Here

If you're on a modern Linux distribution or macOS, Homebrew and the Arch Linux package are the most up-to-date. For the latest features, use cargo install or build from source.

Arch Linux​

Install Yazi with all recommended dependencies on Arch
sudo pacman -S yazi ffmpeg 7zip jq poppler fd ripgrep fzf zoxide resvg imagemagick

Debian / Ubuntu​

Yazi provides an official apt repository. Add it and install:

Install Yazi on Debian/Ubuntu
curl -sSL https://deb.griffo.io/install | sh
sudo apt install yazi

Optional dependencies can be installed separately with apt:

sudo apt install ffmpeg 7zip jq poppler-utils fd-find ripgrep fzf zoxide

Fedora / RHEL​

Install Yazi on Fedora via COPR
sudo dnf copr enable lihaohong/yazi
sudo dnf install yazi

Optional dependencies:

sudo dnf install ffmpeg p7zip jq poppler fd-find ripgrep fzf zoxide resvg ImageMagick

macOS (Homebrew)​

Install Yazi on macOS
brew install yazi ffmpeg-full sevenzip jq poppler fd ripgrep fzf zoxide resvg imagemagick-full
note

ffmpeg-full and imagemagick-full provide the broadest format support. If you don't need video thumbnails, ffmpeg (lighter) suffices.

Windows​

Scoop:

Install Yazi via Scoop
scoop install yazi

Optional dependencies:

scoop install ffmpeg 7zip jq poppler fd ripgrep fzf zoxide

WinGet:

Install Yazi via WinGet
winget install sxyazi.yazi

Nix / NixOS​

Install Yazi via nix-env
nix-env -iA nixos.yazi

Or via home-manager:

Home-manager configuration
programs.yazi = {
  enable = true;
};

Snap​

Install Yazi via Snap
sudo snap install yazi --classic

Snap packages are confined — some features (like image preview) may be limited.

Flatpak​

Run Yazi via Flatpak
flatpak run io.github.sxyazi.yazi

Cargo (crates.io)​

Install using Rust's package manager
cargo install --force yazi-build

The --force flag ensures you get the latest version. Requires the Rust toolchain.

Build from Source​

Clone and build Yazi from source
git clone https://github.com/sxyazi/yazi.git
cd yazi
cargo build --release --locked
sudo cp target/release/yazi target/release/ya /usr/local/bin/

See the Build from Source guide for detailed instructions including debug builds.

Official Binaries​

Pre-compiled binaries for Linux, macOS, and Windows are available on the GitHub Releases page. Download and place them in your PATH.