← ← Back to Tutorials

zoxide install Ubuntu

2025-12-01
5 min
Video & FAQ
Beginner

How to Install zoxide on Ubuntu

This guide will walk you through installing zoxide on Ubuntu and other Debian-based Linux distributions.

Prerequisites

  • Ubuntu 18.04 or later (or any Debian-based distribution)
  • Terminal access
  • Internet connection

Installation Methods

Method 1: Using Cargo (Recommended)

If you have Rust installed, you can use Cargo to install zoxide:

Note: If you don't have Rust installed, you can install it using:

Method 2: Using Pre-built Binary

Download the pre-built binary from the zoxide releases page:

Method 3: Using Package Manager (if available)

Some distributions may have zoxide in their repositories:

Shell Configuration

After installation, you need to initialize zoxide in your shell configuration file.

For Bash

Add the following to your ~/.bashrc:

Then reload your shell:

For Zsh

Add the following to your ~/.zshrc:

Then reload your shell:

For Fish

Add the following to your ~/.config/fish/config.fish:

Then reload your shell:

Verify Installation

Test that zoxide is installed correctly:

You should see the version number printed.

Basic Usage

Once installed and configured, you can start using zoxide:

Troubleshooting

Command Not Found

If you get "command not found" after installation:

  1. Check that zoxide is in your PATH:
  1. If not found, add the installation directory to your PATH in ~/.bashrc or ~/.zshrc:
  1. Reload your shell configuration.

Permission Denied

If you get permission errors:

  1. Make sure the binary is executable:
  1. Or install to a user directory instead:

Next Steps