Files
spacesops-startos/instructions.md
T
spacesopsandClaude Opus 4.7 35c1013520 Build SpacesOps StartOS package (v1.0.0:0)
Initial .s9pk for SpacesOps, targeting StartOS 0.4.0.x with SDK 1.5.1.

- Single managed daemon from spacesops/spacesops:v1.0.0 (x86_64 + aarch64),
  keeping the image entrypoint (/app/docker-entrypoint.sh node server.js).
  Forces PLATFORM_HOST=0.0.0.0 / PLATFORM_PORT=7264 so the StartOS proxy can
  reach the app. Single `ui` interface on 7264.
- Depends on the Spaces service (>=0.0.9:3) and auto-wires the spaced RPC creds:
  main.ts mounts the Spaces `main` volume read-only at /spaces-data, execs a
  read of its store.json inside the subcontainer, and injects SPACED_RPC_USER/
  PASSWORD + SPACED_RPC_URL=http://spaces.startos:7225. Throws to retry until
  Spaces is installed and seeded.
- Generates a Nostr operator keypair (nostr-tools, bundled by ncc) and a strong
  session secret in idempotent init tasks (.once() reads, allowWriteAfterConst
  merges). Actions: show-operator-credentials, import-operator-key,
  show-admin-credentials (surfaces the fixed admin/Whatever! login with a
  warning), configure-platform (optional relay/mode/CoinGecko/SUBSD).
- Install alert warns to install Spaces first and about the fixed admin
  credential. Backs up the `main` volume.
- Icon: icon.svg (source spacesops.svg). The `spaces` dependency uses
  assets/spaces-icon.png for its Marketplace metadata.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-26 10:28:18 -04:00

54 lines
2.0 KiB
Markdown

# SpacesOps
SpacesOps is a web platform for confirming Spaces ownership and selling subspace
names. It connects to the Spaces `spaced` daemon, signs operator events on Nostr,
and optionally adds pricing and subname-purchase features.
## Before you start: install Spaces
SpacesOps **requires the Spaces service**. Install **Spaces** from the
Marketplace and let it sync **before** using SpacesOps. SpacesOps connects to it
automatically — you do not need to enter any spaced RPC credentials. Until
Spaces is installed and its credentials are ready, SpacesOps will keep
restarting; this is expected.
## First run
On install, StartOS automatically:
1. Generates a **Nostr operator keypair** that SpacesOps signs events with.
2. Generates a strong **session secret**.
There is no setup wizard. Once Spaces is reachable, open the **Web UI** from the
SpacesOps dashboard.
## ⚠️ Admin credentials — important
The admin area is protected by a **fixed, well-known** login that is baked into
the image and **cannot be changed**:
- **Username:** `admin`
- **Password:** `Whatever!`
The **Show Admin Credentials** action displays these. Because the admin area can
run SQL and manage tenants, **keep this service private** — use it over Tor or
your LAN, and do **not** expose its admin routes to the public internet.
## Actions
- **Show Operator Credentials** — view your Nostr operator npub, nsec, and hex
keys.
- **Import Operator Key** — replace the operator keypair with one you provide (a
64-character hex secret key). This changes your operator identity and restarts
the service.
- **Show Admin Credentials** — view the fixed admin login (with the warning
above).
- **Configure Platform** — optionally set the Nostr relay, theme mode, CoinGecko
pricing, and a SUBSD backend. Pricing and subname-purchase features stay off
until you configure them here. Saving restarts the service.
## Backups
Backing up SpacesOps captures everything under `/data` — all databases, signed
artifacts, your operator keypair, and your settings.