Mirror from bluesky-social/pds
update env
+43
-41
+43
-41
README.md
+43
-41
README.md
···
4
4
5
5
## Table of Contents
6
6
7
-
* [FAQ](#faq)
8
-
* [What is Bluesky?](#what-is-bluesky)
9
-
* [What is AT Protocol?](#what-is-at-protocol)
10
-
* [How can developers get invite codes?](#how-can-developers-get-invite-codes)
11
-
* [Where is the code?](#where-is-the-code)
12
-
* [What is the current status of federation?](#what-is-the-current-status-of-federation)
13
-
* [What should I know about running a PDS in the developer sandbox?](#what-should-i-know-about-running-a-pds-in-the-developer-sandbox)
14
-
* [Self\-hosting PDS](#self-hosting-pds)
15
-
* [Preparation for self\-hosting PDS](#preparation-for-self-hosting-pds)
16
-
* [Open your cloud firewall for HTTP and HTTPS](#open-your-cloud-firewall-for-http-and-https)
17
-
* [Configure DNS for your domain](#configure-dns-for-your-domain)
18
-
* [Check that DNS is working as expected](#check-that-dns-is-working-as-expected)
19
-
* [Automatic install on Ubuntu 20\.04/22\.04 or Debian 11/12](#automatic-install-on-ubuntu-20042204-or-debian-1112)
20
-
* [Installing manually on Ubuntu 22\.04](#installing-manually-on-ubuntu-2204)
21
-
* [Open ports on your Linux firewall](#open-ports-on-your-linux-firewall)
22
-
* [Install Docker](#install-docker)
23
-
* [Uninstall old versions](#uninstall-old-versions)
24
-
* [Set up the repository](#set-up-the-repository)
25
-
* [Install Docker Engine](#install-docker-engine)
26
-
* [Verify Docker Engine installation](#verify-docker-engine-installation)
27
-
* [Set up the PDS directory](#set-up-the-pds-directory)
28
-
* [Create the Caddyfile](#create-the-caddyfile)
29
-
* [Create the PDS env configuration file](#create-the-pds-env-configuration-file)
30
-
* [Start the PDS containers](#start-the-pds-containers)
31
-
* [Download the Docker compose file](#download-the-docker-compose-file)
32
-
* [Create the systemd service](#create-the-systemd-service)
33
-
* [Start the service](#start-the-service)
34
-
* [Verify your PDS is online](#verify-your-pds-is-online)
35
-
* [Obtain your PDS admin password](#obtain-your-pds-admin-password)
36
-
* [Generate an invite code for your PDS](#generate-an-invite-code-for-your-pds)
37
-
* [Connecting to your server](#connecting-to-your-server)
38
-
* [Manually updating your PDS](#manually-updating-your-pds)
39
-
* [PDS environment variables](#pds-environment-variables)
7
+
- [PDS](#pds)
8
+
- [Table of Contents](#table-of-contents)
9
+
- [FAQ](#faq)
10
+
- [What is Bluesky?](#what-is-bluesky)
11
+
- [What is AT Protocol?](#what-is-at-protocol)
12
+
- [How can developers get invite codes?](#how-can-developers-get-invite-codes)
13
+
- [Where is the code?](#where-is-the-code)
14
+
- [What is the current status of federation?](#what-is-the-current-status-of-federation)
15
+
- [What should I know about running a PDS in the developer sandbox?](#what-should-i-know-about-running-a-pds-in-the-developer-sandbox)
16
+
- [Self-hosting PDS](#self-hosting-pds)
17
+
- [Preparation for self-hosting PDS](#preparation-for-self-hosting-pds)
18
+
- [Open your cloud firewall for HTTP and HTTPS](#open-your-cloud-firewall-for-http-and-https)
19
+
- [Configure DNS for your domain](#configure-dns-for-your-domain)
20
+
- [Check that DNS is working as expected](#check-that-dns-is-working-as-expected)
21
+
- [Automatic install on Ubuntu 20.04/22.04 or Debian 11/12](#automatic-install-on-ubuntu-20042204-or-debian-1112)
22
+
- [Installing manually on Ubuntu 22.04](#installing-manually-on-ubuntu-2204)
23
+
- [Open ports on your Linux firewall](#open-ports-on-your-linux-firewall)
24
+
- [Install Docker](#install-docker)
25
+
- [Uninstall old versions](#uninstall-old-versions)
26
+
- [Set up the repository](#set-up-the-repository)
27
+
- [Install Docker Engine](#install-docker-engine)
28
+
- [Verify Docker Engine installation](#verify-docker-engine-installation)
29
+
- [Set up the PDS directory](#set-up-the-pds-directory)
30
+
- [Create the Caddyfile](#create-the-caddyfile)
31
+
- [Create the PDS env configuration file](#create-the-pds-env-configuration-file)
32
+
- [Start the PDS containers](#start-the-pds-containers)
33
+
- [Download the Docker compose file](#download-the-docker-compose-file)
34
+
- [Create the systemd service](#create-the-systemd-service)
35
+
- [Start the service](#start-the-service)
36
+
- [Verify your PDS is online](#verify-your-pds-is-online)
37
+
- [Obtain your PDS admin password](#obtain-your-pds-admin-password)
38
+
- [Generate an invite code for your PDS](#generate-an-invite-code-for-your-pds)
39
+
- [Connecting to your server](#connecting-to-your-server)
40
+
- [Manually updating your PDS](#manually-updating-your-pds)
41
+
- [PDS environment variables](#pds-environment-variables)
40
42
41
43
42
44
## FAQ
···
250
252
PDS_HOSTNAME="example.com"
251
253
PDS_JWT_SECRET="$(openssl rand --hex 16)"
252
254
PDS_ADMIN_PASSWORD="$(openssl rand --hex 16)"
253
-
PDS_REPO_SIGNING_KEY_K256_PRIVATE_KEY_HEX="$(openssl ecparam --name secp256k1 --genkey --noout --outform DER | tail --bytes=+8 | head --bytes=32 | xxd --plain --cols 32)"
254
255
PDS_PLC_ROTATION_KEY_K256_PRIVATE_KEY_HEX="$(openssl ecparam --name secp256k1 --genkey --noout --outform DER | tail --bytes=+8 | head --bytes=32 | xxd --plain --cols 32)"
255
256
256
257
cat <<PDS_CONFIG | sudo tee /pds/pds.env
257
258
PDS_HOSTNAME=${PDS_HOSTNAME}
258
259
PDS_JWT_SECRET=${PDS_JWT_SECRET}
259
260
PDS_ADMIN_PASSWORD=${PDS_ADMIN_PASSWORD}
260
-
PDS_REPO_SIGNING_KEY_K256_PRIVATE_KEY_HEX=${PDS_REPO_SIGNING_KEY_K256_PRIVATE_KEY_HEX}
261
261
PDS_PLC_ROTATION_KEY_K256_PRIVATE_KEY_HEX=${PDS_PLC_ROTATION_KEY_K256_PRIVATE_KEY_HEX}
262
-
PDS_DB_SQLITE_LOCATION=/pds/pds.sqlite
263
-
PDS_BLOBSTORE_DISK_LOCATION=/pds/blocks
264
-
PDS_DID_PLC_URL=https://plc.bsky-sandbox.dev
265
-
PDS_BSKY_APP_VIEW_URL=https://api.bsky-sandbox.dev
266
-
PDS_BSKY_APP_VIEW_DID=did:web:api.bsky-sandbox.dev
267
-
PDS_CRAWLERS=https://bgs.bsky-sandbox.dev
262
+
PDS_DATA_DIRECTORY=/pds
263
+
PDS_BLOBSTORE_DISK_LOCATION=/pds/blobs
264
+
PDS_DID_PLC_URL=https://plc.directory
265
+
PDS_BSKY_APP_VIEW_URL=https://api.bsky.app
266
+
PDS_BSKY_APP_VIEW_DID=did:web:api.bsky.app
267
+
PDS_CRAWLERS=https://bsky.network
268
+
PDS_MOD_SERVICE_URL=https://mod.staging.bsky.dev
269
+
PDS_MOD_SERVICE_DID=did:plc:kfiaag3o66qk75mfgwebyyns
268
270
PDS_CONFIG
269
271
```
270
272