Docs / Guides / Bluesky handle

Bluesky handle

you.runs-on.dev as your verified Bluesky handle, via DNS, no app hosting involved.

What you'll end up with

Bluesky can verify a custom domain as your handle by checking for a TXT record at _atproto.you.runs-on.dev containing your account's DID. Once verified, you.runs-on.dev shows on your profile in place of a *.bsky.social handle.

The record

domains/you.json

"subdomains": {
  "_atproto": { "TXT": ["did=did:plc:abc123"] }
}

Replace did:plc:abc123 with your account's actual DID, found in the Bluesky app under Settings → Advanced → your DID.

Steps

  1. Fork the registry and edit domains/you.json to the record above.
  2. Open a pull request. Once merged, the TXT record is synced to DNS automatically.
  3. In the Bluesky app: Settings → Account → Handle → I have my own domain → enter you.runs-on.dev → No DNS Panel → Verify DNS Record.

How to tell it worked

Bluesky confirms the handle change immediately once it can resolve the TXT record and the DID matches. Your profile then shows you.runs-on.dev as your handle.