Hitchhiker's Guide to the Atmosphere

An Encyclopedia Galactica with various guides and writings to help you understand the atmosphere(atproto ecosystem).

Bitesize Proto: Two PDS containers at the same time; synchronized swimmers

Run two PDSs container instances on the same machine, or if crafty elsewhere.

Bailey Townsend 🦀
Jan 23

Bitesize Proto: Upserting ATProto Records

Tired of creating duplicate records in a repo from your atproto app?

Bailey Townsend 🦀
Jan 16
1

Help! I've migrated to a new PDS, and my Bluesky doesn't work

A checklist of things to check when you move to a new PDS and new posts don't show or your account doesn't load on Bluesky

Bailey Townsend 🦀
Jan 7
1

Beyond the Statusphere: Part 2, ATProto OAuth, the TLDR

Gain a working knowledge of ATProto OAuth and feel confident implementing it in your projects.

Bailey Townsend 🦀
Jan 2
10

Quick getting started notes on tap

Bluesky released a new backfill/firehose tool today called Tap. These are some quick notes on trying it out to make it easier for anyone to give it a go.

Bailey Townsend 🦀
Dec 13 '25
3

Beyond the Statusphere: Part 1, Resolving the User's PDS

Learn why it's important to resolve the user's PDS and use that in your ATProto applications.

Bailey Townsend 🦀
Nov 23 '25

AMAA

Ask me anything AT Protocol, with guests!

Bailey Townsend 🦀
Nov 13 '25
7

A blob in the bucket

Learn how to setup your self hosted PDS to use an S3 object store for blob storage.

Bailey Townsend 🦀
Nov 12 '25
1

Host a PDS via a Cloudflare Tunnel

Learn how to use a Cloudflare Tunnel to host your PDS on a local network.

Bailey Townsend 🦀
Nov 12 '25

What the hell is a rotation key?

Why it's important that YOU should have a rotation key and backups for your Bluesky/AT Protocol account that is hosted on a third party PDS

Bailey Townsend 🦀
Nov 3 '25
2

What the hell is the atmosphere anyway

A slightly less technical intro to the technical side of Bluesky

Bailey Townsend 🦀
Sep 13 '25
6