tranquil.farm / tranquil-pds
Our Personal Data Server from scratch! tranquil.farm
pds rust database fun oauth atproto
238
fork

Configure Feed

Select the types of activity you want to include in your feed.

adding k8s docs and a more generalized doc #12

open opened by
dsx.sh targeting main from dsx.sh/tranquil-pds: k8s-doc-updates

I recently went through some pain in getting Tranquil all set up on my k8s cluster. Luckily some of my 'biggest' pain was in the mystery of the email server, which has been resolved in the meantime.

Regardless, I added a bunch more detail on a somewhat generic k8s deployment, with some context for secrets, secret generation, etc.

I also set up a "general configuration" doc that took some of the details and context from all the install-x docs and compiled it together into a more generalized information source with all the env vars I could find centralized into one place.

Sorry if this kind of work is already being done elsewhere, I wanted to get this somewhere so I can point friends to so they do their own PDS.

Labels

None yet.

assignee

None yet.

Participants 1
AT URI
at://did:plc:6so2rykrnjmzebbr2zbwbqbx/sh.tangled.repo.pull/3mlcn4ezr6p22
+8
Interdiff #0 → #1
docs/general-configuration.md

This file has not been changed.

+8
docs/install-kubernetes.md
··· 8 8 9 9 See [configuration.md](configuration.md) for what each env var does and why the secret ones matter. This guide covers the Kubernetes-specific wiring. 10 10 11 + Simply, the container image expects: 12 + - A TOML config file mounted at `/etc/tranquil-pds/config.toml` (or passed via `--config`) 13 + - `DATABASE_URL` - postgres connection string 14 + - `BLOB_STORAGE_PATH` - path to blob storage (mount a PV here) 15 + - `PDS_HOSTNAME` - your PDS hostname (without protocol) 16 + - `JWT_SECRET`, `DPOP_SECRET`, `MASTER_KEY` - generate with `openssl rand -base64 48` 17 + - `CRAWLERS` - typically `https://bsky.network` 18 + 11 19 --- 12 20 13 21 ## TLS and DNS

History

4 rounds 0 comments
sign up or login to add to the discussion
dsx.sh submitted #3
diff interdiff
6 commits
expand
863d8480
adding k8s docs and a more generalized doc
d9c99c04
oops didnt actually mean to take that out
44c7255f
removing gen config altogether, agree with nel
697cf8c2
expanding example.toml a tiny bit and reworking k8s a little
541abaf4
rewording, and some sentence simplification
30e09e90
more rewording
merge conflicts detected
expand
expand 0 comments
dsx.sh submitted #2
diff interdiff
5 commits
expand
863d8480
adding k8s docs and a more generalized doc
d9c99c04
oops didnt actually mean to take that out
44c7255f
removing gen config altogether, agree with nel
697cf8c2
expanding example.toml a tiny bit and reworking k8s a little
541abaf4
rewording, and some sentence simplification
expand 0 comments
dsx.sh submitted #1
diff
2 commits
expand
863d8480
adding k8s docs and a more generalized doc
d9c99c04
oops didnt actually mean to take that out
expand 0 comments
dsx.sh submitted #0
diff
1 commit
expand
863d8480
adding k8s docs and a more generalized doc
expand 0 comments