Lewis' BS PDS Sandbox#

When I'm actually done then yeah let's make this into a proper official-looking repo perhaps under an official-looking account or something.

This project implements a Personal Data Server (PDS) implementation for the AT Protocol.

Uses PostgreSQL instead of SQLite, S3-compatible blob storage, and aims to be a complete drop-in replacement for Bluesky's reference PDS implementation.

In fact I aim to also implement a plugin system soon, so that we can add things onto our own PDSes on top of the default BS.

I'm also taking ideas on what other PDSes lack, such as an on-PDS webpage that users can access to manage their records and preferences.

:3

Running locally#

The reader will need rust installed locally.

I personally run the postgres db, and an S3-compatible object store with podman compose up db objsto -d.

Run the PDS directly:

just run

Configuration is via environment variables:

DATABASE_URL          postgres connection string
S3_BUCKET             blob storage bucket name
S3_ENDPOINT           S3 endpoint URL (for MinIO etc)
AWS_ACCESS_KEY_ID     S3 credentials
AWS_SECRET_ACCESS_KEY
AWS_REGION
PDS_HOSTNAME          public hostname of this PDS
APPVIEW_URL           appview to proxy unimplemented endpoints to
RELAYS                comma-separated list of relay WebSocket URLs

Optional email stuff:

MAIL_FROM_ADDRESS     sender address (enables email notifications)
MAIL_FROM_NAME        sender name (default: BSPDS)
SENDMAIL_PATH         path to sendmail binary

Development

just              shows available commands
just test         run tests (spins up postgres and minio via testcontainers)
just lint         clippy + fmt check
just db-reset     drop and recreate local database

The test suite uses testcontainers so you don't need to set up anything manually for running tests.

What's implemented#

Most of the com.atproto.* namespace is done. Server endpoints, repo operations, sync, identity, admin, moderation. The firehose websocket works. OAuth is not done yet.

See TODO.md for the full breakdown of what's done and what's left.

Structure

src/
  main.rs           server entrypoint
  lib.rs            router setup
  state.rs          app state (db pool, stores)
  api/              XRPC handlers organized by namespace
  auth/             JWT handling
  repo/             postgres block store
  storage/          S3 blob storage
  sync/             firehose, relay clients
  notifications/    email service
tests/              integration tests
migrations/         sqlx migrations

License

idk