objective categorical abstract machine language personal data server
1# (optional) debug, info, warn, or error
2# default: info
3# PDS_LOG_LEVEL=info
4
5# (optional) directory where databases and blobs will be stored
6# default: ./data [relative to cwd]
7# PDS_DATA_DIR=./data
8
9# (required) hostname where this PDS is running
10# for handles to work, you should set A records for *.{PDS_HOSTNAME} and PDS_HOSTNAME to point to this server
11PDS_HOSTNAME=
12
13# (optional) the PDS's DID
14# default: did:web:{PDS_HOSTNAME}
15# PDS_DID=
16
17# (optional) whether an invite code is needed to create an account
18# default: true
19# PDS_INVITE_CODE_REQUIRED=true
20
21# (required) the rotation key the PDS will use, in multibase format
22# tip: run the `gen-keys` binary to generate this (more info in readme)
23PDS_ROTATION_KEY_MULTIBASE=
24
25# (required) the key used to sign JWTs
26# tip: run the `gen-keys` binary to generate this (more info in readme)
27PDS_JWK_MULTIBASE=
28
29# (required) the PDS admin password
30# this can be used to access com.atproto.admin.* endpoints as well as the /admin dashboard
31PDS_ADMIN_PASSWORD=
32
33# (optional) relays/crawlers to inform to subscribe to this PDS, comma-separated
34# default: https://bsky.network
35# PDS_CRAWLERS=https://bsky.network
36
37# (optional [but recommended]) a secret token used to generate DPoP nonces; 32 bytes, base64url
38# tip: run the `gen-keys` binary to generate this (more info in readme)
39# PDS_DPOP_NONCE_SECRET=
40
41# (optional) a link to a .ico favicon to display on the frontend
42# default: /public/favicon.ico
43# PDS_FAVICON_URL=/public/favicon.ico
44
45# (optional) email config (see readme for details)
46# auth uri should look like smtp[s]://user:pass@host[:port]
47# sender should look like e@mail.com or Name <e@mail.com>
48# without setting these, emails will be logged to stdout
49# PDS_SMTP_STARTTLS=false
50# PDS_SMTP_AUTH_URI=
51# PDS_SMTP_SENDER=
52
53# (optional) S3 config (see readme for details)
54# set these to back up your databases and/or blobs to S3(-compatible storge)
55# PDS_S3_BLOBS_ENABLED=false
56# PDS_S3_BACKUPS_ENABLED=false
57# PDS_S3_BACKUP_INTERVAL_S=3600
58# PDS_S3_ENDPOINT=
59# PDS_S3_REGION=
60# PDS_S3_BUCKET=
61# PDS_S3_ACCESS_KEY=
62# PDS_S3_SECRET_KEY=
63# PDS_S3_CDN_URL=