INSTALL.md

Installation

eza is available for Windows, macOS and Linux.

Cargo (crates.io)

If you already have a Rust environment set up, you can use the cargo install command:

cargo install eza

Cargo will build the eza binary and place it in $HOME/.local/share/cargo/bin/eza.

Cargo (git)

If you already have a Rust environment set up, you can use the cargo install command in your local clone of the repo:

git clone https://github.com/eza-community/eza.git
cd eza
cargo install --path .

Cargo will build the eza binary and place it in $HOME/.cargo.

Arch Linux

Eza is available in the [extra] repository of Arch Linux.

pacman -S eza

Debian and Ubuntu

Eza is available from deb.gierens.de. The GPG public key is in this repo under deb.asc.

First make sure you have the gpg command, and otherwise install it via:

sudo apt update
sudo apt install -y gpg

Then install eza via:

sudo mkdir -p /etc/apt/keyrings
wget -qO- https://raw.githubusercontent.com/eza-community/eza/main/deb.asc | sudo gpg --dearmor -o /etc/apt/keyrings/gierens.gpg
echo "deb [signed-by=/etc/apt/keyrings/gierens.gpg] http://deb.gierens.de stable main" | sudo tee /etc/apt/sources.list.d/gierens.list
sudo chmod 644 /etc/apt/keyrings/gierens.gpg /etc/apt/sources.list.d/gierens.list
sudo apt update
sudo apt install -y eza

Note: In strict apt environments, you may need to add the target: echo "deb [arch=amd64 signed-by=...

Nix (Linux, MacOS)

Note Installing packages imperatively isn't idiomatic Nix, as this can lead to many issues.

Eza is available from Nixpkgs and from the flake in this repository.

For nix profile users:

nix profile install nixpkgs#eza

For nix-env users:

nix-env -i eza

Declarative Nix Installations

• Simple NixOS installation: rfaulhaber/dotfiles
• Using the flake via NixOS: hallettj/home.nix
• Using home-manager on NixOS: Misterio77/nix-config

Gentoo

On Gentoo, eza is available as a package sys-apps/eza:

emerge --ask sys-apps/eza

openSUSE

Eza is available at openSUSE:Factory/eza:

zypper ar https://download.opensuse.org/tumbleweed/repo/oss/ factory-oss
zypper in eza

The preceding repository also contains the Bash, Fish, and Zsh completions.

Fedora

Eza is available as the eza package in the official Fedora repository.

sudo dnf install eza

Void Linux

Eza is available as the eza package in the official Void Linux repository.

sudo xbps-install eza

Termux

Eza is available as the eza package in the official Termux repository.

pkg install eza

Manual (Linux)

Example is for x86_64 GNU, replaces the file names if downloading for a different arch.

wget -c https://github.com/eza-community/eza/releases/latest/download/eza_x86_64-unknown-linux-gnu.tar.gz -O - | tar xz
sudo chmod +x eza
sudo chown root:root eza
sudo mv eza /usr/local/bin/eza

If exa was installed before, replace it with eza:

sudo rm -f /usr/local/bin/exa
sudo ln -s /usr/local/bin/eza /usr/local/bin/exa

Brew (MacOS)

Eza is available from Homebrew.

To install eza, run:

brew install eza

MacPorts (macOS)

On macOS, eza is also available via MacPorts.

To install eza, run:

sudo port install eza

Winget (Windows)

Eza is available on Winget.

To install eza, run:

winget install eza-community.eza

Scoop (Windows)

Eza is available from Scoop.

To install eza, run:

scoop install eza

Completions

For zsh:

Note Change ~/.zshrc to your preferred zsh config file.

Clone the repository:

git clone https://github.com/eza-community/eza.git

Add the completion path to your zsh configuration:

Replace <path_to_eza> with the actual path where you cloned the eza repository.

echo 'export FPATH="<path_to_eza>/completions/zsh:$FPATH"' >> ~/.zshrc

Reload your zsh configuration:

source ~/.zshrc

For zsh with homebrew:

In case zsh completions don't work out of the box with homebrew, add the following to your ~/.zshrc:

if type brew &>/dev/null; then
    FPATH="$(brew --prefix)/share/zsh/site-functions:${FPATH}"
    autoload -Uz compinit
    compinit
fi

For reference:

• https://docs.brew.sh/Shell-Completion#configuring-completions-in-zsh
• Homebrew/brew#8984