Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Install

Fastmash runs on Linux, macOS 15 and later, and Windows 11. For Windows, use PowerShell 7.4 or later.

Choose a method

Use your system’s package manager when you can. It installs prebuilt programs and brings you later versions with your other updates.

Your systemRecommendedUpdates
Debian, Ubuntuapt repositorysudo apt update, then sudo apt install --only-upgrade fastmash
Fedora, RHEL and similardnf repositorysudo dnf upgrade fastmash
macOS, or Linux with HomebrewHomebrewbrew upgrade fastmash
Linux, macOS, or WSL2Quick installRun it again
WindowsNative archiveReplace the extracted folder

All of these install prebuilt programs. If you prefer to compile Fastmash yourself, see Cargo.

Debian and Ubuntu

The signed apt repository provides updates through apt on Linux. Install the tools needed to download and inspect its key:

sudo apt install ca-certificates curl gnupg
curl -fsSLo fastmash.gpg https://packages.fastmash.io/fastmash.gpg
gpg --show-keys --fingerprint fastmash.gpg

Check that the key fingerprint is:

76C1 7E23 B7D3 F8FD ED36 D31A 7BAC 7AF6 644B D290

Then add the repository and install Fastmash:

sudo install -m 644 fastmash.gpg /usr/share/keyrings/fastmash.gpg
echo "deb [arch=amd64 signed-by=/usr/share/keyrings/fastmash.gpg] https://packages.fastmash.io/apt stable main" |
  sudo tee /etc/apt/sources.list.d/fastmash.list
sudo apt update
sudo apt install fastmash

Later versions arrive through sudo apt update and sudo apt upgrade. The key is trusted only for this repository.

For Debian 10, Ubuntu 20.04 and newer. Remove it with sudo apt remove fastmash.

Fedora, RHEL and similar

The signed dnf repository provides updates on Linux, with package and repository signature checks enabled:

sudo curl -fsSLo /etc/yum.repos.d/fastmash.repo https://packages.fastmash.io/fastmash.repo
sudo dnf install fastmash

dnf asks to trust the signing key on first use. Before confirming, check that its fingerprint is 76C1 7E23 B7D3 F8FD ED36 D31A 7BAC 7AF6 644B D290, the same key used by the apt repository above. Update with sudo dnf upgrade fastmash.

For Fedora, RHEL 8 and newer. Remove it with sudo dnf remove fastmash.

Homebrew

With Homebrew on macOS 15 or later, or on Linux:

brew install pederbe/tap/fastmash

Homebrew downloads the same tested programs as the Fastmash release archives. Installation needs no Rust compiler and does not rebuild Fastmash.

Update with brew upgrade fastmash and remove it with brew uninstall pederbe/tap/fastmash.

Quick install

On Linux, macOS or inside WSL2:

curl -fsSL https://fastmash.io/install.sh | sh

Downloads the latest release archive for your system, checks its checksum and installs it into ~/.local/bin. The installer prints a command to try when it finishes. If your shell cannot find fastmash, see Command not found. Run the same command again to update this installation.

Choose another writable directory with FASTMASH_INSTALL_DIR:

curl -fsSL https://fastmash.io/install.sh | env FASTMASH_INSTALL_DIR="$HOME/bin" sh

Use the same directory when updating. To read the installer’s help without installing anything:

curl -fsSL https://fastmash.io/install.sh | sh -s -- --help

If a download or checksum check fails, your existing installation stays in place. Check your connection and retry. For a permission error, choose a directory you can write to with FASTMASH_INSTALL_DIR.

Single packages and archives

These downloads install the latest release without adding a repository. You update them yourself.

Arch Linux package

Use the Arch package recipe to install the prebuilt executable through makepkg and pacman. No Rust compiler is needed. To update, rebuild the package from the current recipe.

Debian or RPM package

Download the .deb package for Debian or Ubuntu, or the .rpm package for Fedora, RHEL and similar systems, from the release downloads. Save it in an empty folder, then open a terminal there.

On Debian or Ubuntu:

sudo apt install ./fastmash_*.deb

On Fedora, RHEL and similar:

sudo dnf install ./fastmash-*.rpm

To update, repeat these steps with a fresh download.

Linux and macOS archives

  1. Open the release downloads and choose the archive for your system:

    SystemArchive ending
    Linux or WSL2x86_64-unknown-linux-musl.tar.gz
    macOSaarch64-apple-darwin.tar.gz
  2. Extract the archive, then open a terminal in the extracted folder containing fastmash.

  3. Move the executable into your local command directory and try it:

    mkdir -p ~/.local/bin
    mv -f fastmash ~/.local/bin/fastmash
    printf '1\n2\n' | ~/.local/bin/fastmash sum 1
    

The final command prints 3. If your shell cannot find fastmash by name, see Command not found. To update, repeat these steps with a fresh download.

With Cargo

If you already use Rust, Cargo offers two routes.

cargo-binstall downloads the same prebuilt executables as the release archives, without compiling. On Linux or WSL2, run:

cargo binstall fastmash --strategies crate-meta-data

On macOS or Windows, select its single executable:

cargo binstall fastmash --strategies crate-meta-data --bin fastmash

These commands install the published binaries and stop with an error if the download is unavailable.

To compile Fastmash from source with cargo install, use the latest stable Rust toolchain. On Linux or WSL2:

rustup target add x86_64-unknown-linux-musl
cargo install --locked --target x86_64-unknown-linux-musl fastmash

On macOS 15 or later, select its single executable:

cargo install --locked --bin fastmash fastmash

Check that it works

In Bash, or use the PowerShell example:

printf '1\t2\n3\t4\n' | fastmash sum 1 mean 2

The summary shows 4 for the sum and 3 for the mean. Next: the quick start.

Command not found

For a quick installation or an archive installed in the default directory, try the executable directly:

~/.local/bin/fastmash --version

PATH lists the directories your shell searches for commands, in order. If the direct command prints the version, add ~/.local/bin to PATH. In Fish:

fish_add_path "$HOME/.local/bin"

In Bash, add this line to ~/.bashrc. In Zsh, add it to ~/.zshrc, then open a new terminal:

export PATH="$HOME/.local/bin:$PATH"

If Bash starts a login shell, add the line to ~/.bash_profile instead. Replace ~/.local/bin with your chosen directory if you set FASTMASH_INSTALL_DIR.

To see which installation your shell uses:

command -v fastmash

Update that installation with its original method, or put your preferred installation directory first in PATH. In Fish, fish_add_path --move moves an existing directory to the front.

On Windows

Use PowerShell 7.4 or later on Windows 11.

  1. Open the release downloads and choose the archive ending in x86_64-pc-windows-msvc.tar.gz.

  2. Extract it and keep the extracted folder somewhere permanent.

  3. Search Windows for Edit environment variables for your account. Edit Path and add the folder containing fastmash.exe.

  4. Open a new PowerShell terminal and run:

    fastmash --version
    

It prints the installed version. Continue with the PowerShell quick start for files and pipelines. To update, replace the extracted folder and keep its location on Path. To uninstall, remove that folder and its Path entry. No Rust compiler or separate Visual C++ runtime installation is needed.

For Linux workflows, you can also use WSL2 and follow the Linux instructions. Keep WSL2 data in the Linux file system rather than under /mnt/c.

Uninstall

Package managers remove Fastmash with their own commands, shown above. For the quick installer or a downloaded archive:

rm ~/.local/bin/fastmash

If you chose another directory with FASTMASH_INSTALL_DIR, remove its fastmash file instead. Removing the executable does not remove your data.

If you installed with Cargo or cargo-binstall:

cargo uninstall fastmash

Fastmash keeps no configuration files, caches or background services.

See System requirements for building from source and verifying release archives.