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, download the public signing key for the repository:

# In releases older than Debian 12 and Ubuntu 22.04, the folder `/etc/apt/keyrings` does not exist by default, and it should be created before the curl command.
# sudo mkdir -p -m 755 /etc/apt/keyrings
 
curl -sS https://pkg.authzed.com/apt/gpg.key | sudo gpg --dearmor --yes -o /etc/apt/keyrings/authzed.gpg

Then add the list file for the repository:

echo "deb [signed-by=/etc/apt/keyrings/authzed.gpg] https://pkg.authzed.com/apt/ * *"  | sudo tee /etc/apt/sources.list.d/authzed.list
sudo chmod 644 /etc/apt/sources.list.d/authzed.list  # helps tools such as command-not-found to work correctly

Alternatively, if you want to use the new deb822-style authzed.sources format, put the following in /etc/apt/sources.list.d/authzed.sources:

Types: deb
URIs: https://pkg.authzed.com/apt/
Suites: *
Components: *
Signed-By: /etc/apt/keyrings/authzed.gpg

Once the you've defined the sources and updated your apt cache, it can be installed just like any other package:

sudo apt update
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
[authzed-fury]
name=AuthZed Fury Repository
baseurl=https://pkg.authzed.com/yum/
enabled=1
gpgcheck=0
EOF

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

Docker

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.

Source

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).

© 2025 AuthZed.