Service: PDS Admin - EyevinnOSC/community GitHub Wiki

PDS Admin

PDS Admin (serviceId eyevinn-pds-admin, license MIT) is a web-based administration interface for a Bluesky Personal Data Server (PDS). It offers a graphical UI for tasks that would otherwise need raw HTTP API calls. In Eyevinn Open Source Cloud (OSC) it is a long-running service instance.

What it can do

  • Create invite codes so new users can join your PDS.
  • List the accounts registered on your PDS.
  • Review the health of the underlying PDS process.

Creating an instance

A running Bluesky PDS instance is required first; see Service: Bluesky Personal Data Server (serviceId bluesky-social-pds). Get its URL with describe-service-instance; it looks like https://myname.bluesky-social-pds.auto.prod-se.osaas.io.

Then call create-service-instance with serviceId: "eyevinn-pds-admin":

{
  "name": "myadmin",
  "PdsUrl": "https://myname.bluesky-social-pds.auto.prod-se.osaas.io"
}

Wait with wait-for-service-ready or get-instance-status, then open the instance URL in a browser; the admin UI connects to your PDS.

Equivalent OSC CLI usage:

npx -y @osaas/cli create eyevinn-pds-admin myadmin \
  -o PdsUrl="https://myname.bluesky-social-pds.auto.prod-se.osaas.io"

Options

Option Required Type Meaning
name Yes string Name of the instance. Letters, digits and underscore (^\w+$); OSC limits names to 20 characters.
PdsUrl Yes string Full URL of the Bluesky PDS instance to manage, for example https://myname.bluesky-social-pds.auto.prod-se.osaas.io.

Resources