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. |