SpiceDB Documentation
Getting Started
Installing Zed

Installing Zed

Zed is built as a standalone executable file which simplifies installation.

However, one should prefer one of the recommended installation methods detailed below.

Recommended methods

Debian packages

Debian-based Linux (opens in a new tab) users can install SpiceDB packages by adding an additional apt source.

First ensure the following dependencies are installed:

sudo apt update && sudo apt install -y curl ca-certificates gpg

Next, we can add, trust, and update the official SpiceDB apt source:

curl https://pkg.authzed.com/apt/gpg.key | sudo apt-key add -
sudo sh -c 'echo "deb https://pkg.authzed.com/apt/ * *" > /etc/apt/sources.list.d/authzed.list'
sudo apt update

Install as usual:

sudo apt install -y zed

RPM packages

RPM-based Linux (opens in a new tab) users can install packages by adding a new yum repository:

sudo cat << EOF >> /etc/yum.repos.d/Authzed-Fury.repo
name=AuthZed Fury Repository

Install as usual:

sudo dnf install -y zed

Homebrew (macOS)

macOS users can install packages by adding a Homebrew tap (opens in a new tab):

brew install authzed/tap/zed

Other methods


Container images are available for AMD64 and ARM64 architectures on the following registries:

You can pull down the latest stable release:

docker pull authzed/zed

Afterwards, you can run it with docker run:

docker run --rm authzed/zed version

Downloading the binary

Visit the GitHub release page for the latest release (opens in a new tab). Scroll down to the Assets section and download the appropriate artifact.


Clone the GitHub repository:

git clone git@github.com:authzed/zed.git

Enter the directory and build the binary using mage:

cd zed
go build ./cmd/zed

You can find more commands for tasks such as testing, linting in the repository's CONTRIBUTING.md (opens in a new tab).

© 2024 AuthZed.