Installation
Homebrew
Section titled “Homebrew”Homebrew (macOS and Linux, Intel + ARM) is the easiest way to install:
brew install asheliahut/tap/deaddropThat 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:
brew upgrade deaddrop # updatebrew uninstall deaddrop && brew untap asheliahut/tap # removePrebuilt binaries
Section titled “Prebuilt binaries”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.
VERSION=v1.0.0TARGET=x86_64-unknown-linux-musl # static build; or aarch64-unknown-linux-musl, *-linux-gnucurl -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/VERSION=v1.0.0TARGET=aarch64-apple-darwin # or x86_64-apple-darwin on Intelcurl -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/$v = "v1.0.0"$t = "x86_64-pc-windows-msvc" # or aarch64-pc-windows-msvcInvoke-WebRequest "https://github.com/asheliahut/deaddrop/releases/download/$v/deaddrop-$v-$t.zip" -OutFile deaddrop.zipExpand-Archive deaddrop.zip -DestinationPath .# then move deaddrop-$v-$t\deaddrop.exe somewhere on your PATHVerify the download
Section titled “Verify the download”Each archive has a .sha256 file next to it, and SHA256SUMS lists them all:
curl -LO "https://github.com/asheliahut/deaddrop/releases/download/$VERSION/SHA256SUMS"sha256sum --check --ignore-missing SHA256SUMS # macOS: shasum -a 256 -c --ignore-missing SHA256SUMSVerify build provenance
Section titled “Verify build provenance”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:
gh attestation verify "deaddrop-$VERSION-$TARGET.tar.gz" --repo asheliahut/deaddropFrom source
Section titled “From source”You need Rust 1.95 or newer (deaddrop uses the 2024 edition):
cargo install --locked --git https://github.com/asheliahut/deaddropOr clone and build:
git clone https://github.com/asheliahut/deaddropcd deaddropcargo build --release --locked./target/release/deaddrop --version- Set up shell completions.
- Write a config file:
deaddrop config example > ~/.config/deaddrop/config.toml. - Try the quick start.