The xxd: command not found error occurs because the xxd utility is often bundled with Vim rather than being a standalone package. On many minimal Linux installations (like Docker containers or server cores), it is omitted by default. 1. Fast Fix: Installation
To resolve this, install the package that provides xxd for your specific operating system:
Ubuntu / Debian / Kali / Linux Mint:sudo apt update && sudo apt install xxd (or sudo apt install xxd on newer versions)
CentOS / RHEL / Fedora:sudo dnf install vim-common or sudo dnf install xxd Arch Linux:sudo pacman -S vim or sudo pacman -S xxd
macOS:Usually pre-installed, but if missing, use Homebrew: brew install vim Alpine Linux:apk add xxd 2. Troubleshooting common scenarios
Resolving the "xxd command not found" Error
The xxd command is a popular tool used for creating and parsing hexadecimal dumps. It's commonly used on Unix-like systems, including Linux and macOS. However, if you're encountering the "xxd command not found" error, it's likely because the xxd package is not installed on your system or not properly configured. In this article, we'll guide you through the steps to resolve this issue.
What is xxd?
xxd is a hexadecimal dump tool that can be used to create and parse hexadecimal representations of binary data. It's often used for:
Causes of the "xxd command not found" Error
The "xxd command not found" error typically occurs when:
xxd package is not installed on your system.xxd package is not properly configured or installed.xxd by default.Solutions to Resolve the "xxd command not found" Error
The issue is caused by the absence of the Vim package. Installing vim or vim-common via the system's package manager is the definitive fix.
The xxd command is a powerful command-line utility used to create hexadecimal dumps of binary files and can even reverse them back into binary format. If you see a "command not found" error, it typically means the utility is missing from your system or is not in your executable PATH. 🛠️ Why is it missing?
On most modern systems, xxd is not a standalone application; it is actually bundled with the Vim text editor (specifically within the vim-common package). If you have a "minimal" installation of a Linux distribution or are working inside a lightweight Docker container, Vim—and thus xxd—might not be installed by default. 🚀 How to Install xxd
You can resolve this error by installing the package that contains xxd using your system's package manager: ubuntu - VS code - xxd: command not found - Stack Overflow
If you're using an Ubuntu or Debian-based Linux distribution, you can install xxd using the following command: xxd command not found
sudo apt-get install xxd
The xxd: command not found error is typically easy to resolve by installing the xxd or vim-common package. Developers using containers (especially Alpine-based) should proactively add xxd to their Dockerfiles. For systems without installation privileges, use od or hexdump as fallback alternatives.
Understanding and fixing this error saves valuable debugging time and ensures hex dumps remain a reliable part of your command-line toolkit.
Related commands: hexdump, od, base64, strings, binwalk
If you see the error "xxd: command not found," it usually means the utility isn't installed or is missing from your shell's search path.
is a powerful tool for creating hex dumps and reversing them, and it is most commonly bundled with the text editor. Hacker News Quick Fix: Installation by OS
The quickest way to resolve this is to install the package that provides the Ubuntu / Debian / Kali: sudo apt update && sudo apt install xxd (Note: On some older versions, it may be part of the vim-common CentOS / RHEL / Fedora: sudo yum install vim-common sudo dnf install vim-common Arch Linux: sudo pacman -S vim Alpine Linux: apk add xxd
is typically pre-installed. If missing, it can be installed via as part of the Download the Vim for Windows installer; is included in the installation directory. Stack Overflow Why is it missing? Minimal Environments:
Lightweight Docker containers or "minimal" OS installs often omit non-essential tools to save space. Vim Alternatives: If you use instead of the standard Vim, the binary might not be linked to your path automatically. Special Modes:
is not available in certain recovery modes (like macOS Recovery) unless you call it from the main OS volume path.
conda update breaks if xxd (from vim-common) is not installed #1082
after updating conda today on a minimal centos image the conda installation was broken. Python complained about problems with md5. add xxd via vim as a dep for ubuntu? · Issue #685 - GitHub
The xxd command is often missing from minimal or fresh Linux installations because it is typically bundled with the Vim text editor rather than being a standalone utility. How to Install xxd
To fix the "command not found" error, install the package that contains xxd for your specific operating system:
make test reports failures if xxd is not installed #3797 - GitHub
How to Fix "xxd command not found" in Linux and macOS Encountering the "xxd command not found" error can be frustrating, especially when you are trying to view binary files, perform hex dumps, or patch a file. This error simply means the xxd utility—a powerful tool usually bundled with the Vim editor—is missing from your system’s PATH.
Here is a quick guide on how to get xxd back on your machine, regardless of your operating system. What is xxd? The xxd: command not found error occurs because
xxd is a command-line utility that creates a hex dump of a given file or standard input. It can also convert a hex dump back into its original binary form. While it is technically a standalone tool, it is almost always distributed as part of the Vim text editor package. How to Fix it on Linux
Most Linux distributions do not install xxd by default in their "minimal" versions. To fix this, you need to install the package that provides it. Ubuntu / Debian / Kali / Linux Mint
On Debian-based systems, xxd is often found in the xxd or vim-common package.
sudo apt update sudo apt install xxd # If the above fails, try: sudo apt install vim-common Use code with caution. CentOS / RHEL / Fedora / AlmaLinux
On Red Hat-based systems, you generally need the vim-common package.
sudo dnf install vim-common # Or for older versions: sudo yum install vim-common Use code with caution. Arch Linux
In Arch, xxd is included in the base vim package or as a standalone via xxd. sudo pacman -S xxd Use code with caution. How to Fix it on macOS
MacOS usually comes with xxd pre-installed as part of the system's Vim distribution. If you are seeing "command not found," your PATH might be broken, or you may be using a very stripped-down environment. The easiest fix is to install it via Homebrew: brew install vim Use code with caution.
This will install the latest version of Vim along with a fresh version of the xxd binary. Verifying the Installation
Once the installation is complete, verify that the command works by checking its version: xxd -v Use code with caution.
You should see output similar to xxd 2023-08-25 by Juergen Weigert. Common Alternatives to xxd
If you cannot install packages on your current system, you can often use these built-in alternatives to achieve similar results: hexdump: Usually available on almost all Unix-like systems. Usage: hexdump -C filename od (Octal Dump): A POSIX standard tool. Usage: od -t x1 filename
python: If you have Python installed, you can use a one-liner.
Usage: python3 -c "import sys; print(sys.stdin.read().hex())" < filename
The "xxd command not found" error is almost always solved by installing the vim-common or xxd package through your system's package manager. Once installed, you'll have full access to hex dumping and binary manipulation features.
Are you trying to patch a specific binary or just inspect a file's contents using xxd? Creating hexadecimal dumps of files or data streams
The midnight oil burned low in the dimly lit server room. , a veteran systems administrator, was facing a ghost in the machine. A critical configuration file had been corrupted, and he needed to examine its raw binary structure to find the stray null byte wreaking havoc on the production database.
"Just a quick hex dump," Elias muttered, his fingers dancing across the mechanical keyboard. He typed the familiar command: xxd config_backup.bin
He pressed Enter, expecting a neat grid of hexadecimal values. Instead, the screen spat back a cold, indifferent error: bash: xxd: command not found The Investigation
Elias froze. xxd was the Swiss Army knife of the binary world—a standard utility that should be there by default. He checked his environment, wondering if his PATH had been mangled.
Step 1: He ran echo $PATH. Everything looked normal: /usr/local/bin, /usr/bin, /bin. Step 2: He tried which xxd. Nothing.
Step 3: He checked the OS version. It was a minimal install of CentOS—a "lean and mean" build meant for high performance, but it had been stripped of its essential tools. The ghost wasn't a bug; it was a missing package. The Realisation
In many Linux distributions like Fedora, RHEL, and CentOS, xxd isn't a standalone tool—it is bundled within the vim-common or vim-core packages. The developers of this server image had installed a minimal version of Vim, or perhaps no Vim at all, leaving the system "blind" to binary data. The Resolution
Elias sighed, reaching for the package manager. "If you want a job done right," he whispered, "you have to give the server its eyes back."
He typed the command to summon the missing utility:sudo yum install vim-common
The terminal scrolled with progress bars as the system fetched the 700KB package. Once finished, Elias tried again: xxd config_backup.bin | head -n 5
This time, the screen filled with the beautiful, rhythmic rows of hex and ASCII. There it was—at offset 0x000045: a 00 where a 20 should have been. With a quick edit and a restart, the production database hummed back to life. The ghost was gone, and xxd was home. How to Fix "xxd: command not found"
If you find yourself in Elias's shoes, use the command for your specific system: Operating System Command to Install Ubuntu / Debian sudo apt-get install xxd CentOS / RHEL / Fedora sudo yum install vim-common Arch Linux sudo pacman -S vim Fedora CoreOS rpm-ostree install vim-common If you'd like, I can: Show you common xxd commands for debugging files. Explain how to convert a hex dump back into a binary file.
Provide a bash-only alternative if you can't install new packages.
Let me know how you'd like to dive deeper into binary analysis! ubuntu - VS code - xxd: command not found - Stack Overflow
brew install xxd
Note: Homebrew’s xxd formula is often a standalone package, so you don’t need to install full Vim.
xxdxxd file.bin