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:
- authzed/zed (opens in a new tab)
- ghcr.io/authzed/zed (opens in a new tab)
- quay.io/authzed/zed (opens in a new tab)
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).