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 🦀
January 23, 2026

Bitesize Proto: Upserting ATProto Records

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

Bailey Townsend 🦀
January 16, 2026
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 🦀
January 06, 2026

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 🦀
January 01, 2026
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 🦀
December 13, 2025
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 🦀
November 23, 2025

AMAA

Ask me anything AT Protocol, with guests!

Bailey Townsend 🦀
November 13, 2025
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 🦀
November 11, 2025
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 🦀
November 11, 2025

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 🦀
November 03, 2025
2

What the hell is the atmosphere anyway

A slightly less technical intro to the technical side of Bluesky

Bailey Townsend 🦀
September 13, 2025
5