Installing SpiceDB on macOS

This document outlines how to install SpiceDB for systems running Apple's macOS.

Every release of SpiceDB publishes for both Intel (AMD64) and M-series (ARM64) versions of macOS.

Installing SpiceDB using Homebrew

The quickest way to get started with SpiceDB on macOS is to use Homebrew. This will install both the zed, the command-line tool, and the SpiceDB server binary.

brew install authzed/tap/spicedb authzed/tap/zed

Updating SpiceDB using Homebrew

SpiceDB will log a warning if you are running an out-of-date version. To ensure that you are using the latest stable release, you can run the following command to upgrade an existing installation of SpiceDB:

brew upgrade authzed/tap/spicedb

Manually installing SpiceDB binary for macOS

Manual installations of SpiceDB for macOS can use the following command to download the latest release for their platform and architecture:

curl https://api.github.com/repos/authzed/spicedb/releases | \
jq --arg platform $(uname | tr '[:upper:]' '[:lower:]') --arg arch $(uname -m) '.[0].assets.[] | select (.name | contains($platform+"_"+$arch)) | .browser_download_url' -r | \
xargs curl -LO

Afterwards, it is up to the user to extract the archive and decide where to place its contents on their systems.

We recommend following the XDG Base Directory Specification (opens in a new tab) if you're not trying to install SpiceDB system-wide.