Files
spacesops-startos/instructions.md
T
spacesopsandClaude Opus 4.7 147f51d710 Rename SUBSD_* env vars to SUBS_* to match upstream refactor
The upstream SpacesOps app refactored its SUBSD_* environment variables to
SUBS_* (verified against server.js in spacesops/spacesops:v1.0.0). Update the
package to match so the configured values reach the app:

- main.ts: inject SUBS_URI_VALUE / SUBS_RPC_USER / SUBS_RPC_PASSWORD.
- configurePlatform action + storeJson: rename store keys subsd*→subs* and the
  field labels/descriptions (SUBS URL / SUBS RPC User / SUBS RPC Password).
- README, instructions, release notes: SUBSD→SUBS.

Note: the image's /app/setup-spacesops-env.sh still exports SUBSD_* defaults
(partial upstream refactor) — see report; vars the package does not set (e.g.
SUBS_RPC_URL) currently have no in-image default.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-26 12:19:51 -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 SUBS 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.