this repo has no description
lewis.moe
1# BSPDS
2A production-grade Personal Data Server (PDS) for the AT Protocol. Drop-in replacement for Bluesky's reference PDS, using postgres and s3-compatible blob storage.
3## Features
4- Full AT Protocol support (`com.atproto.*` endpoints)
5- OAuth 2.1 provider (PKCE, DPoP, PAR)
6- WebSocket firehose (`subscribeRepos`)
7- Multi-channel notifications (email, discord, telegram, signal)
8- Built-in web UI for account management
9- Per-IP rate limiting
10## Quick Start
11```bash
12cp .env.example .env
13podman compose up -d
14just run
15```
16## Configuration
17See `.env.example` for all configuration options.
18## Development
19Run `just` to see available commands.
20```bash
21just test # run tests
22just lint # clippy + fmt
23```
24## Production Deployment
25### Quick Deploy (Docker/Podman Compose)
26```bash
27cp .env.prod.example .env.prod
28# Edit .env.prod with your values (generate secrets with: openssl rand -base64 48)
29podman-compose -f docker-compose.prod.yml up -d
30```
31### Full Installation Guides
32| Guide | Best For |
33|-------|----------|
34| **Native Installation** | Maximum performance, full control |
35| [Debian](docs/install-debian.md) | Debian 13+ with systemd |
36| [Alpine](docs/install-alpine.md) | Alpine 3.23+ with OpenRC |
37| [OpenBSD](docs/install-openbsd.md) | OpenBSD 7.8+ with rc.d |
38| **Containerized** | Easier updates, isolation |
39| [Containers](docs/install-containers.md) | Podman with quadlets (Debian) or OpenRC (Alpine) |
40| **Orchestrated** | High availability, auto-scaling |
41| [Kubernetes](docs/install-kubernetes.md) | Multi-node k8s cluster deployment |
42## License
43TBD