All you need to know about pds.witchcraft.systems
Find a file
2025-05-29 19:26:13 +09:00
README.md Migration steps 2025-05-29 19:26:13 +09:00

Witchcraft Systems Personal Data Sanctum

About the PDS

This is a Personal Data Sanctum (PDS) hosted by Witchcraft Systems, physically located in Tokyo, Japan. Signups require an invite code, which can be obtained by sending a message to us on our main account.

While you can move your main account to our PDS, we do not recommend doing so if you don't have an alternative option just in case (i.e. you use a Bluesky PBC PDS, since moving your main account to a custom PDS makes it impossible to move it back to a PDS hosted by the Bluesky PBC).

The PDS is operated on a best-effort basis, meaning we will try to keep it up and running, but we cannot guarantee 100% uptime. You can check our uptime so far on our status page and decide if this is acceptable for you.

The PDS itself is backed up nightly to multiple locations, with the backups being regularly verified to ensure data integrity. All the public data stored on the PDS is also available in an S3 bucket, which will continue to be available even if the PDS itself goes down, and can be used to migrate your account to another PDS if needed.

In case of anything significant affecting the PDS, we will do our best to tell you about it on our PDS announcements account, in advance where possible.

How to sign up

  1. Get an invite code.
  2. Go to bsky.app and select "Create Account".
  3. Click on "You are creating an account on Bluesky Social", and set a custom provider URL to https://pds.witchcraft.systems.
  4. Enter your invite code and the rest of the required information.
  5. Congratulations! You now have a PDS account. You may want to subscribe to @announcements.pds.witchcraft.systems to get updates about the PDS.
  6. Recommended! Set up a custom did:plc key for your account. You can use boat to both generate a key pair (store it somewhere safe!) and to add the public key to your account. This will allow you to point your DID to a different PDS without using our PDS's key.

How to move an existing account to our PDS

  1. Remember that migrating from the default Bluesky PDS to a custom PDS is a one-way operation.
  2. Get an invite code.
  3. Follow this guide to migrate using the goat tool. Otherwise, you can use the ATP INTERNECTIONAL AIRPORT for a more user-friendly experience, but it is currently in alpha and may not work as expected. Keep in mind that those tools are made for did:plc; If you have a did:web - good luck, you figured it out when you created the account, so surely you'll figure it out now too :^)
  4. Done!
  5. Recommended if using did:plc! Set up a custom did:plc key for your account. You can use boat to both generate a key pair (store it somewhere safe!) and to add the public key to your account. This will allow you to point your DID to a different PDS without using our PDS's key.

How to leave if we ever go down

We have no plans of shutting down the PDS, but for your benefit, here are the rough steps to migrate your data to another PDS if we ever do:

  1. Have custom keys in your did:plc or use a did:web.
  2. Grab the files for your DID from the nightly backups S3 bucket.
  3. Upload the CAR contents and the blobs to your new PDS.
  4. Point your DID at the new PDS.
  5. Update your handle if it was a subdomain of pds.witchcraft.systems.