nostream: your relay, your rules

/hero · nostream 3.5.1

01 Who it's for

One relay. Three ways to run it.

Whether you are opening a relay to everyone, charging for access, or keeping it private, nostream ships the knobs you need, without forking.

PUB 01

Public relay operators

Serve the open network without getting flattened by it.

Handles floods of traffic without slowing everyone else down

i
Blocks spam before it lands, without turning people away

i
Grows with your audience by adding more machines

i

PAID 02

Paid relay operators

Turn a relay into a service. Admission fees settle over Lightning.

Get paid the way you already do

i
Invite-only groups and member checks, built in

i
Set your own prices and member lists

i

SELF 03

Self-hosters

A relay for you, your family or your community, on your own box.

One command and you are running

i
Your posts stay yours — copy them out any time

i
You decide who can post and who can read

i

02 Feature pillars

Everything a relay needs. Nothing it doesn't.

Protocol breadth, network reach and the ops tooling to keep it healthy, in one codebase you can read.

NIP

Speaks the whole protocol

Works with the Nostr apps your people already use — chat, feeds, search and encrypted groups — with nothing to configure.

NET

Reachable from anywhere

Publish an .onion or .i2p address with a flag, so people on censored or privacy-first networks can still reach you.

OPS

Stay on top of your relay

See how your relay is doing at a glance, spot trouble before your users do, and change settings without fear of breaking things.

Charge for admission

Turn publish access into a service. Invoices settle over Lightning with the provider you already run.

LIM

Keeps abusive traffic out

Keeps spam and abusive traffic from slowing the relay for everyone else, so normal clients stay fast.

I/O

Your data, portable

Take your events with you. Back up, migrate, or seed a new relay whenever you want.

$ nostream export --output backup.jsonl --format jsonl

03 Admin & observability

Know what your relay is actually doing.

A built-in console for operators: no SSH, no SQL, no guessing at 3am.

Login-gated so only you can reach it
Plugs into the monitoring you already run
Health endpoint for load balancers and zero-downtime deploys
Self-hosted probes, labelled as one monitor among many

nostream admin console: Live metrics (1) — Live metrics

Watch traffic and load as it happens, so you catch problems while they are small.

i

nostream admin console: Network health — Network health

Know your relay is reachable and fast from the outside, not just from your own machine.

i

nostream admin console: Honest advertising — Honest advertising

Catches when your relay promises clients something it does not actually do.

i

nostream admin console: Settings editor — Settings editor

Change settings confidently — mistakes are caught before they ship, and undo is one click.

i

nostream admin console: Notifications — Notifications

Hear about trouble first, before your users notice.

i

04 NIPs supported

25 NIPs, advertised in NIP-11.

The same list your relay returns as supported_nips, read straight from the repository at build time.

Marmot MIPs 00, 01, 02, 03: end-to-end encrypted group messaging over Nostr, advertised as supported_mips. →

Ship it

Run your own relay tonight.

Clone, set a secret, start. Docker Compose does the rest.

# clone and configure
$ git clone https://github.com/cameri/nostream.git && cd nostream
$ echo "SECRET=$(openssl rand -hex 128)" > .env
$ pnpm add -g . && nostream start

Choose a deploy path → Open an issue

nostream — a production-ready Nostr relay. Your relay, your rules.