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

2.0 KiB

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.