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 system | Recommended | Updates |
|---|---|---|
| Debian, Ubuntu | apt repository | sudo apt update, then sudo apt install --only-upgrade fastmash |
| Fedora, RHEL and similar | dnf repository | sudo dnf upgrade fastmash |
| macOS, or Linux with Homebrew | Homebrew | brew upgrade fastmash |
| Linux, macOS, or WSL2 | Quick install | Run it again |
| Windows | Native archive | Replace 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
-
Open the release downloads and choose the archive for your system:
System Archive ending Linux or WSL2 x86_64-unknown-linux-musl.tar.gzmacOS aarch64-apple-darwin.tar.gz -
Extract the archive, then open a terminal in the extracted folder containing
fastmash. -
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.
-
Open the release downloads and choose the archive ending in
x86_64-pc-windows-msvc.tar.gz. -
Extract it and keep the extracted folder somewhere permanent.
-
Search Windows for Edit environment variables for your account. Edit Path and add the folder containing
fastmash.exe. -
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.