# Bluesky PDS

> Self-host your Bluesky accounts and posts on your own server.

- Page: https://cgt.octabyte.io/templates/bluesky-pds/
- Category: Social networks
- Ease of use: Some setup. You create an invite code from the app's terminal in Cloudgate, sign up in the Bluesky app with your server as the hosting provider, then set a domain you own as your handle.
- App price: Free. To run it you need Cloudgate (hosted, or free to install yourself) and a server, which hosted Cloudgate can provide.
- License: MIT OR Apache-2.0
- Good for: People, families and small businesses who want their Bluesky accounts on their own server
- Official website: https://atproto.com
- Documentation: https://github.com/bluesky-social/pds#readme
- Source code: https://github.com/bluesky-social/pds
- Last updated: 2026-11-16

## What is Bluesky PDS?

Self-hosted Bluesky PDS: keep your Bluesky accounts, posts and images on your own server and keep using the Bluesky app, with your own domain as handle.

Bluesky PDS is the official open-source Personal Data Server for Bluesky: a self-hosted server that keeps your Bluesky accounts, posts, follows and images on a server you control, while you keep posting from the normal Bluesky app. The accounts it hosts are full Bluesky accounts that anyone on Bluesky can follow.

It doesn't replace the Bluesky app or run a separate network. Your timeline, search and custom feeds still come from Bluesky's services; what changes is where your account lives and who controls it. A bakery, for example, could host its account on its own server, post as @harbourbakery.com, and give its staff accounts by invite only.

The server has no timeline page of its own. Its web address shows sign-up and sign-in screens, and you read and post with Bluesky on the web, iPhone or Android. It suits a person, a family or a small team: the project's recommended small server is sized for 1 to 20 people.

Cloudgate installs Bluesky PDS on a server Cloudgate provides or one you connect and gives it a secure web address. Choose that address carefully: your accounts' identities point to it, so it should not change once the first account exists.

## What you can do with Bluesky PDS

- **Host your Bluesky accounts yourself**: Posts, likes, follows, images and settings for each account are stored on your server instead of Bluesky's.
- **Keep using the Bluesky app**: Read and post in the official Bluesky app on the web, iPhone or Android by choosing your server as the hosting provider.
- **Reach everyone on Bluesky**: Your server joins the Bluesky network, so your posts, replies and follows show up for everyone on Bluesky.
- **Use your own domain as your handle**: Swap the starting handle for a domain you own, such as @yourshop.com, with one DNS record.
- **Decide who joins**: Sign-up needs an invite code from you, so only the people you invite can create an account.
- **Take your account with you**: An account keeps the same identity if it later moves to another server, including back to Bluesky's.
- **Optional email**: Connect an email service to send email confirmations and password-reset codes.

## What happens when you click Deploy?

Deploy link: https://cloudgate.octabyte.app/get-started?template=bluesky-pds

1. **Click Deploy and create your account.** Deploy takes you to Cloudgate. Create an account, or log in if you have one. Bluesky PDS itself is free.
2. **Choose a server.** No server? Get one from Cloudgate: pick a size and a country, and Cloudgate gets it ready. Already have one? Connect it instead.
3. **Cloudgate sets up Bluesky PDS.** It prepares the server, makes the passwords the app needs and starts it. There is nothing to install and nothing to write down.
4. **Open your app and sign in.** Your app gets a free web address to start, without https. Add your own domain, like app.yourshop.com, and Cloudgate secures it with https for you.

## Questions

### Is Bluesky PDS free?

Yes, Bluesky PDS is free and open source under the MIT or Apache 2.0 licence, with no paid edition. You pay only for your server. Hosting an account on Bluesky's own servers is free too, so you self-host for control, not to save money.

### What does a Bluesky PDS do, and what doesn't it do?

A Bluesky PDS stores your accounts' posts, likes, follows, images and settings and manages their identity. It has no timeline of its own; you read and post in the Bluesky app, and the timeline, search, feeds and moderation still come from Bluesky's services. Direct messages are not stored on your server either.

### How do I create the first account on my Bluesky PDS?

Create an invite code with the goat admin tool in the app's terminal in Cloudgate. Then, in the Bluesky app, choose Create account, set the hosting provider to your server's web address and enter the invite code.

### Can I use my own domain as my Bluesky handle?

Yes, and on Cloudgate you should. New accounts start with a handle under your server's address, which only works with a wildcard DNS record Cloudgate doesn't set up, so switch it in the Bluesky app's handle settings to a domain you own by adding the DNS record the app shows.

### Can I move my existing Bluesky account to my own PDS?

Yes, but it is a technical migration with a command-line tool, not a button in the app. The account keeps its identity and posts, and the Bluesky team advises against moving your main account unless you understand the steps, because a mistake can lock you out.

### How many accounts can a Bluesky PDS hold?

Up to 100 at first, because Bluesky's network limits new servers to 100 accounts and raises the limit on request. The project recommends 1 CPU core, 1 GB of memory and 20 GB of disk for 1 to 20 people, so Cloudgate sets it up on a small server.

### Do I need technical skills to run Bluesky PDS?

No. Click Deploy, create your Cloudgate account and choose a server, and Cloudgate sets up Bluesky PDS and gives it a web address. You use it in your browser like any other online tool.

### Do I need my own server for Bluesky PDS?

No. When you deploy Bluesky PDS, hosted Cloudgate can provide a server. If you already rent one, you can connect it instead.
