Video coming soon…

🌐 Setup Bluesky PDS — Host Your Own atproto Personal Data Server

Deploy a Bluesky Personal Data Server (PDS) on Ubuntu with Docker — own your Bluesky identity and data on your own domain, federated into the atproto network. Requires a public domain and HTTPS.

⚠️ This script is provided for demo and testing purposes only. Not intended for production use.

📦 Resources & Setup Scripts

Grab the automated bash script from GitHub to follow along with the video.

⚠️ Requires a public domain with HTTPS to federate. This deploys the PDS on port 3045, but real use needs a reverse proxy with a valid TLS certificate on your domain. Create accounts with pdsadmin.
View on GitHub

Quick Install:

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/social/bluesky-pds/bluesky-pds-ubuntu.sh
chmod +x bluesky-pds-ubuntu.sh
sudo bash bluesky-pds-ubuntu.sh

Tutorial Steps

1 Download the Script

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/social/bluesky-pds/bluesky-pds-ubuntu.sh

2 Make it Executable

chmod +x bluesky-pds-ubuntu.sh

3 Run the Installer

The script installs Docker if needed and starts the Bluesky PDS on port 3045, generating a JWT secret, an admin password, and a PLC rotation key. You must set PDS_HOSTNAME to a public domain you control — federation needs that domain reachable over HTTPS.

sudo bash bluesky-pds-ubuntu.sh

4 Point Your Domain and Create an Account

Set up a reverse proxy with a valid TLS certificate for your PDS_HOSTNAME, then create your first account with the pdsadmin tool (or the API):

pdsadmin account create  # after setting up your domain + HTTPS

Ports Used

PortPurpose
3045PDS (host → container 3000)
⚠️ public domain + HTTPSRequired to federate — reverse proxy with a valid TLS cert
PDS_HOSTNAMEYour public domain; accounts created with pdsadmin
PLC rotation keyGenerated — critical to control of your identity; back it up

Overview

Why Use It

When You Need It

    Who Should Use It

      Real Use Cases

        Main Features

          How to Use After Installation

            Security Best Practices

              Ports and Firewall Notes

              Backup and Maintenance

                Common Mistakes

                  Troubleshooting

                    Alternatives

                    When Not to Use It

                    PrismaTechWork Professional Help

                      Contact Us

                      Frequently Asked Questions