Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update debian install instructions #294

Merged
merged 1 commit into from
Jan 9, 2025
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
30 changes: 22 additions & 8 deletions pages/spicedb/getting-started/install/debian.mdx
Original file line number Diff line number Diff line change
@@ -1,3 +1,5 @@
import { Callout } from 'nextra/components'

# Installing SpiceDB on Ubuntu or Debian

This document outlines how to install SpiceDB for systems running [Debian-like Linux distributions][debianlike].
Expand All @@ -13,24 +15,36 @@ Visit the doc on [Installing SpiceDB on RHEL/Centos][rhel]

## Installing SpiceDB using apt-get

Before installing SpiceDB, you must first install the following dependencies:
First, download the public signing key for the repository:

```sh
sudo apt update && sudo apt install -y curl ca-certificates gpg
# 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/spicedb.gpg
```

These dependencies are used to verify and trust the official SpiceDB Debian repository.
We'll do that by running the following commands:
Then add the list file for the repository:

```sh
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
echo "deb [signed-by=/etc/apt/keyrings/spicedb.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/spicedb.gpg
```

Once the apt has updated with our newly added source for SpiceDB packages, it can be installed just like any other package:
Once the you've defined the sources and updated your apt cache, it can be installed just like any other package:

```sh
sudo apt update
sudo apt install -y spicedb
```

Expand Down
Loading