ContextQMD
Back to Eza

Installation

INSTALL.md

0.23.48.2 KB
Original Source
<!-- SPDX-FileCopyrightText: 2023-2024 Christina Sørensen SPDX-FileContributor: Christina Sørensen SPDX-License-Identifier: EUPL-1.2 -->

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 your CARGO_INSTALL_ROOT. For more details on installation location see the cargo book.

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.

bash
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:

bash
sudo apt update
sudo apt install -y gpg

Then install eza via:

bash
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:

shell
nix profile install nixpkgs#eza

For nix-env users:

shell
nix-env -i eza

Declarative Nix Installations

Gentoo

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

bash
emerge --ask sys-apps/eza

openSUSE

Eza is available at openSUSE:Factory/eza:

bash
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

⚠️ Note: As of Fedora 42, eza is no longer available in the official Fedora repositories due to the absence of an active maintainer.

If you're using Fedora 42 or newer, consider one of these options:

  • Use a pre-built binary from the Releases page
  • Build from source by following the Cargo (git) instructions above

💬 Interested in helping? Become a Fedora package maintainer or reach out via Matrix.

For Fedora versions prior to 42, eza is available in the official repository:

bash
sudo dnf install eza

Void Linux

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

bash
sudo xbps-install eza

Termux

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

bash
pkg install eza

Manual (Linux)

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

shell
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:

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

Pixi (Linux, MacOS, and Windows)

Eza is available in the conda-forge repository and can be installed using Pixi:

shell
pixi global install eza

Brew (MacOS)

Eza is available from Homebrew.

To install eza, run:

shell
brew install eza

MacPorts (macOS)

On macOS, eza is also available via MacPorts.

To install eza, run:

shell
sudo port install eza

Winget (Windows)

Eza is available on Winget.

To install eza, run:

shell
winget install eza-community.eza

Scoop (Windows)

Eza is available from Scoop.

To install eza, run:

shell
scoop install eza

Flox (Linux, macOS, Windows WSL)

Eza is available from Flox.

To install eza, run:

shell
flox install eza

X-CMD (Linux, macOS, Windows WSL, Windows GitBash)

Eza is available from x-cmd.

To install eza, run:

shell
x env use eza
# or
x eza

fox (Linux, macOS)

Eza is available from fox.

To install eza, run:

shell
fox install eza

Completions

For zsh:

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

Clone the repository:
sh
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.

sh
echo 'export FPATH="<path_to_eza>/completions/zsh:$FPATH"' >> ~/.zshrc
Reload your zsh configuration:
sh
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:

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

For reference: