Skip to content

Installation

Homebrew (macOS and Linux, Intel + ARM) is the easiest way to install:

Terminal window
brew install asheliahut/tap/deaddrop

That one command adds the asheliahut/tap tap and installs the prebuilt release binary (the static musl build on Linux). You also get:

  • bash, zsh and fish completions, loaded automatically, with no extra setup
  • the example config at $(brew --prefix)/share/deaddrop/config.example.toml
  • no Gatekeeper prompt on macOS. The release binaries aren’t notarized, but Homebrew doesn’t quarantine what it installs.

The tap updates on every stable release:

Terminal window
brew upgrade deaddrop # update
brew uninstall deaddrop && brew untap asheliahut/tap # remove

Prebuilt binaries are attached to every GitHub release, together with a combined SHA256SUMS file:

Platform Targets
Linux (glibc) x86_64-unknown-linux-gnu, aarch64-unknown-linux-gnu
Linux (static musl) x86_64-unknown-linux-musl, aarch64-unknown-linux-musl
macOS aarch64-apple-darwin (Apple Silicon), x86_64-apple-darwin (Intel)
Windows x86_64-pc-windows-msvc, aarch64-pc-windows-msvc

Archives are named deaddrop-<version>-<target>.tar.gz (.zip on Windows) and contain the binary, README.md, config.example.toml and LICENSE.

Terminal window
VERSION=v1.0.0
TARGET=x86_64-unknown-linux-musl # static build; or aarch64-unknown-linux-musl, *-linux-gnu
curl -LO "https://github.com/asheliahut/deaddrop/releases/download/$VERSION/deaddrop-$VERSION-$TARGET.tar.gz"
tar -xzf "deaddrop-$VERSION-$TARGET.tar.gz"
sudo install "deaddrop-$VERSION-$TARGET/deaddrop" /usr/local/bin/

Each archive has a .sha256 file next to it, and SHA256SUMS lists them all:

Terminal window
curl -LO "https://github.com/asheliahut/deaddrop/releases/download/$VERSION/SHA256SUMS"
sha256sum --check --ignore-missing SHA256SUMS # macOS: shasum -a 256 -c --ignore-missing SHA256SUMS

macOS and Linux tarballs carry signed build provenance proving they were built by the deaddrop repo’s release workflow. Verify one with the GitHub CLI:

Terminal window
gh attestation verify "deaddrop-$VERSION-$TARGET.tar.gz" --repo asheliahut/deaddrop

You need Rust 1.95 or newer (deaddrop uses the 2024 edition):

Terminal window
cargo install --locked --git https://github.com/asheliahut/deaddrop

Or clone and build:

Terminal window
git clone https://github.com/asheliahut/deaddrop
cd deaddrop
cargo build --release --locked
./target/release/deaddrop --version