← ← Back to Tutorials

zoxide install Windows

2025-12-01
5 min
Video & FAQ
Beginner

How to Install zoxide on Windows

This guide will help you install zoxide on Windows using various methods.

Prerequisites

  • Windows 10 or later
  • PowerShell or Command Prompt
  • Internet connection

Installation Methods

Method 1: Using Scoop (Recommended)

The easiest way to install zoxide on Windows is using Scoop:

If you don't have Scoop installed, install it first:

Method 2: Using Cargo

If you have Rust installed, you can use Cargo:

Note: If you don't have Rust installed, download and run the Rust installer from rustup.rs.

Method 3: Using Pre-built Binary

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

  1. Download zoxide-x86_64-pc-windows-msvc.zip from the latest release
  2. Extract the ZIP file
  3. Move zoxide.exe to a directory in your PATH (e.g., C:\Windows\System32 or create a custom directory)

Or using PowerShell:

Shell Configuration

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

For PowerShell

Add the following to your PowerShell profile:

To find your profile location:

If the profile doesn't exist, create it:

Then add the initialization command and reload:

For CMD

For Command Prompt, you can create a batch file or add to your PATH. However, PowerShell is recommended for better zoxide integration.

For Git Bash / WSL

If you're using Git Bash or WSL (Windows Subsystem for Linux), follow the Linux installation instructions.

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 using Scoop, make sure Scoop's shims are in your PATH (usually automatic).

  2. If using Cargo, add Cargo's bin directory to your PATH:

  1. Restart your terminal after modifying PATH.

Execution Policy Error

If you get an execution policy error in PowerShell:

Permission Denied

If you get permission errors:

  1. Make sure you have write permissions to the installation directory
  2. Try running PowerShell as Administrator
  3. Or install to a user directory instead

Next Steps