Categories
AT Protocol Bluesky Federated Social Personal Data Server Self-Hosted Social Decentralized WebStars
Forks
Watchers
Developer links
Bluesky PDS
Bluesky PDS is the official Personal Data Server for hosting your own account on the AT Protocol network, so your posts, follows, and media live on infrastructure you control and still appear across the whole federated Bluesky social graph. An interactive installer sets up the container stack with the Caddy web server handling HTTPS for your domain and wildcard subdomains, creating the data directory, generating secrets, and registering the service with the network's identity directory. You create accounts directly or by invite code, sign in from the standard Bluesky web, iPhone, and Android apps by pointing them at your server address, and brand the sign-in, sign-up, and account screens with your own service name, logo, colors, and background images. Email verification and password resets go through your SMTP provider, rate limiting and blob upload limits are configurable, and the data directory holds everything needed to back up or migrate the instance to a new host later. Built-in tooling covers day-to-day operation: an admin command updates the service, automatic updates run through Watchtower, logs stream to Docker or a file, health and firehose WebSocket endpoints confirm the network can reach you, and an optional Prometheus and Grafana stack tracks accounts, sign-ins, and request latency. Account migration moves an existing identity onto your server when you are ready to leave a hosted provider. Running on a dedicated VPS on RepoCloud with guaranteed CPU, RAM, and SSD, full root SSH access, and a browser serial console. MIT and Apache-2.0 licensed.
Benefits
- Your Account On Your Infrastructure
- Posts, follows, profiles, and media are stored in a data directory on your own server, and the account still federates across the wider Bluesky network and appears in the standard apps.
- Install In Minutes With Script
- An interactive installer prompts for your domain and admin email, deploys the containers, provisions HTTPS through Caddy for the domain and account subdomains, and prints the firewall and DNS requirements.
- Bring Your Existing Bluesky Identity
- Account migration moves an existing identity from a hosted provider onto your server, and the same data directory supports backup and migration to another host when you outgrow the current one.
- Operations Tooling Built In
- Admin commands create accounts and invite codes, Watchtower handles automatic updates, health and firehose endpoints confirm network reachability, and OpenTelemetry metrics feed an optional monitoring dashboard.
Features
- Interactive VPS Installer
- A shell installer deploys the PDS containers on Ubuntu or Debian, configures Caddy for automatic TLS on ports 80 and 443, generates secrets, and creates the data directory under /pds.
- Account And Invite Management
- Administrators create accounts directly or require invite codes for registration, set rate limits and blob upload limits, and use the bundled goat command line tool for admin operations.
- Works With Official Apps
- Users sign in from the Bluesky web, iPhone, and Android apps by entering the PDS address, with federated handles, feeds, relays, and moderation services connected automatically.
- Brandable Auth Screens
- Environment variables set the service name, logo, primary and status colors, background images, and footer links on the sign-in, sign-up, authorization, and account management pages.
- SMTP Email Configuration
- Email verification and password reset messages are sent through any SMTP provider or a local sendmail service using a single connection URL in the environment file.
- Metrics And Monitoring Stack
- OpenTelemetry reports host and service metrics including accounts created, sign-ins, OAuth grants, and request latency, with a ready-made Prometheus, Grafana, and node_exporter stack in the repository.