Get started

Your relay, built by your agent.

Paste one command into your coding agent. It fetches the schematic and builds a production nostream relay on your server, step by step, with checks at every phase.

run-a-decentralized-social-network-relay

v0.1.0

A production Nostr relay (nostream) on Docker — host prep, Postgres and Redis, GHCR image pinning, migrations-before-start, loopback HTTP, reverse-proxy sketches, NIP-11 and /readyz probes, optional settings and tailnet exposure.

infrastructure ./schematics/run-a-decentralized-social-network-relay
build command
build run-a-decentralized-social-network-relay@cameri/schematics

# No plugin? Paste this and let the agent fetch the spec:
# https://schemaformat.ai/schematics/run-a-decentralized-social-network-relay/SCHEMATIC.md
Read the schematic ↗ GitHub ↗

Works in Claude Code · Cursor · Codex · OpenCode · Pi

01 What the schematic builds

The upstream deploy path, phase by phase.

  1. P0

    Host prep

    Docker Engine, Compose v2, disk for Postgres, firewall with no public relay port.

  2. P2

    Bootstrap

    Deploy root, .env at mode 600, generated secrets, bundled postgresql.conf.

  3. P4

    Start the stack

    Postgres and Redis healthy, migrations run, then the relay on a pinned GHCR image.

  4. P5

    Verify

    relay-verify.sh checks NIP-11, /healthz, /readyz and the loopback-only bind.

  5. P7

    Expose

    wss:// through Caddy, nginx, Cloudflare Tunnel or a tailnet, never 0.0.0.0.

Prefer to do it by hand? Choose a deploy path. Browse other schematics on schemaformat.ai ↗.