Getting Started
PDS Admin is a web-based administration interface for managing a Bluesky Personal Data Server (PDS). It provides a graphical UI for tasks that would otherwise require raw HTTP API calls — such as creating invite codes, managing accounts, and reviewing server health.
You must have a running PDS instance before deploying PDS Admin. See Service: Bluesky Personal Data Server for instructions on setting one up.
Prerequisites
- An Eyevinn Open Source Cloud account
- A running Bluesky PDS instance (its URL is required during setup)
Step-by-step guide
Step 1: Get the URL of your PDS instance
Navigate to My Active Services and click on your PDS instance card. Copy the instance URL — it looks like https://myname.bluesky-social-pds.auto.prod.osaas.io.
Step 2: Create a PDS Admin instance
Navigate to PDS Admin and click Create pds-admin.
| Field | Description |
|---|---|
| Name | A short alphanumeric name for this admin instance |
| PdsUrl | The full URL of the PDS instance you want to manage |
Click Create and wait for the instance to turn green.
Step 3: Open the admin UI
Click Open on the instance card. The PDS Admin interface connects to your PDS and lets you manage it through the browser.
Usage example
Once the admin UI is open you can:
- Create invite codes — generate codes for new users to join your PDS
- List accounts — see all accounts registered on your PDS
- Review server status — check the health of the underlying PDS process
CLI usage
npx -y @osaas/cli create eyevinn-pds-admin myadmin \
-o PdsUrl="https://myname.bluesky-social-pds.auto.prod.osaas.io"