Bluesky is a decentralized microblogging social media service based on open standards (AT Protocol) and open source infrastructure so that social communication can be as open and interoperable as the web itself. The AT Protocol (Authenticated Transfer Protocol aka atproto) is a federated protocol for large-scale distributed social applications.
The three core services in a network are Personal Data Server (PDS), Relays and App Views. A personal data server is your home in the cloud. This is the server that hosts your data, distribute it, manage your identity and orchestrate requests to other services to give you your views. However, the goal of the AT protocol is to ensure that a user on one PDS can move and migrate their account to a new PDS without the server’s involvement.
In this blog we will describe how you can setup your own Personal Data Server based on open source made available as a service all for free.
Step 1: Create an account in Eyevinn Open Source Cloud
Navigate to www.osaas.io and click on Login/Signup. Enter your email to create an account and enter the login code you receive in your inbox. If this is the first time you logged in you need to create a tenant first.
Step 2: Create your own PDS
Navigate to Bluesky Personal Data Server by entering this text in the search bar in the top bar.
Click on the tab Service secrets and click on New Secret to create a secret for your administration password.
Click on the button “Create pds” and enter the name of your PDS and a reference to the secret you created.
Leave the input DnsName empty for now. This will be used when you add a CDN in front of the server and use a custom domain name. Press create and wait for the indicator on the instance card to turn green.
Step 3: Create an invitation code
Now you have your own PDS up and running. To create an account on the server you need to first create an invitation code. This is done by sending an HTTP request to the PDS API. In this example we will use an HTTP API client available online.
Use Basic auth as authentication method and admin as user and the password is the administration password that you created above. As URL you enter the URL available on the instance card and add /xrpc/com.atproto.server.createInviteCode
In the body you enter the following JSON:
{ "useCount": 1 }
The code returned in the response is the invitation code, in this case demo-blog-bluesky-social-pds-auto-prod-osaas-io-5ito3-t5umt. This is the code you are using when creating an account on this server.
Step 4: Create an account
Download the Bluesky social app on your appstore. When registering a new account select a custom hosting provider and enter the URL to the PDS created. Use the invitation code and enter email and password. Now you will have an account created with a handle @ and you are ready to go!
Advanced: Custom domain and CDN
To use a custom domain name for your service you need to be able to administer a DNS domain and CDN. We will not go through this in detail in this blog post. What you need to setup is the following:
- 1. Decide and register a root domain name, e.g.
my.org - 2. Decide what domain name you will use for the PDS, e.g.
pds.my.org - 3. Create an SSL certificate for
*.pds.my.organdpds.my.org - 4. Create a PDS in OSC as before with the addition that you set
DNS_NAMEtopds.my.org - 5. Setup a CDN property / distribution where origin is the URL to the PDS created above, e.g.
demo-blog.bluesky-social-pds.auto.prod.osaas.ioand use the SSL cert created in 3. It is important that the CDN uses the origin host in the request to the origin. Consult your CDN provider for how to configure this. - 6. Create DNS records
*.pds.my.organdpds.my.orgto point to the CDN distribution created in 5.
Conclusion
Creating your own Bluesky Personal Data Server based on open source is achievable with only a few click of a button and a quick way to get your own self-hosted account to join the conversation in this open social media network.