Guide

> _
What is Nostr What is nostrbtc Getting Started Dashboard Features Security FAQ

What is Nostr

// the protocol

Nostr (Notes and Other Stuff Transmitted by Relays) is a decentralized protocol for social networking. Unlike Twitter, Facebook, or any centralized platform, no single company owns or controls Nostr. Your identity is a cryptographic key pair — you own it, not a corporation.

When you post on Nostr, your messages are signed with your private key and sent to relays. Relays are servers that store and distribute your posts. Anyone running a relay helps keep the network alive. If one relay goes down or censors you, your data still exists on others.

// keys, not accounts

On Nostr, you don't create an "account" with a username and password. Instead, you generate a key pair:

  • Public key (npub) — your identity, like a username. You share this with everyone. Starts with npub1.
  • Private key (nsec) — your password. Never share this. Whoever has it controls your identity. Starts with nsec1.

// your keys = your identity. back up your nsec and never paste it into websites.

// nostr clients

You interact with Nostr through client apps, similar to how you use email through Gmail or Outlook. Popular clients:

// any client works with nostrbtc.com relay — just add our relay address in your client's settings.

What is nostrbtc

// paid relay with superpowers

nostrbtc.com is a premium Nostr relay that you pay for with Bitcoin Lightning. The Lightning paywall keeps out spam and bots — only real users who pay sats can write here.

But it's more than just a relay. When you subscribe, you get a full suite of tools to protect and showcase your Nostr identity:

Auto-Sync Real-time sync via persistent relay connections. Post anywhere, it appears here instantly.
Data Backup Events synced across 13 relays via negentropy every hour. Download JSON anytime.
NIP-05 Identity Get [email protected] verified address included free.
Tor Access Connect via .onion address for extra privacy. No IP logging ever.
Nostr Wrapped Stats dashboard: posts, reactions, zaps, top friends — shareable with one click.
Nostr Card Shareable profile page with custom links — like Linktree, powered by Nostr.
Follow Backup Your follow list is synced and downloadable. Never lose your social graph.
Broadcast Push all your events to 6 backup relays with one click from your dashboard.
Gift Subs Gift relay access to a friend via website or DM bot.
DM Bot Subscribe, renew, gift, and manage your account entirely via Nostr DMs.
Notifications Get important updates via encrypted Nostr DMs.

// pricing

Two plans, both paid with Lightning. No accounts, no email, no KYC — just sats and your npub.

  • Monthly: 2,100 sats/month
  • Annual: 21,000 sats/year (save ~17%)

Reading is always free — anyone can read events from the relay without subscribing.

Getting Started

// new to nostr

If you don't have a Nostr identity yet:

1

Download a Nostr client.

2

Create your key pair in the client. It will generate your npub and nsec automatically.

3

Back up your nsec (private key) somewhere safe. Write it down. If you lose it, you lose your identity forever.

4

Copy your npub from the client's profile section.

5

Go to nostrbtc.com/subscribe, paste your npub, choose a plan, and pay with Lightning. Or subscribe via DM — send subscribe to @northranger on Nostr.

6

After payment, add wss://nostrbtc.com to your client's relay list.

// that's it. your events will start syncing automatically in real-time.

// already on nostr

If you already have an npub and use Nostr:

1

Go to nostrbtc.com/subscribe and paste your npub. Or DM subscribe to @northranger on Nostr.

2

Pay with Lightning (2,100 sats/month or 21,000 sats/year).

3

Add wss://nostrbtc.com to your client's relay list.

4

Go to your Dashboard and log in with your npub. You'll receive a login code via Nostr DM.

Your existing events will be automatically synced from your other relays. The initial sync typically completes within minutes.

// adding the relay to your client

Every Nostr client has a relay settings section. Here's where to find it:

  • Damus: Settings → Relays → Add Relay → enter wss://nostrbtc.com
  • Amethyst: Drawer → Relays → + button → enter wss://nostrbtc.com
  • Primal: Settings → Network → Relays → Add → enter wss://nostrbtc.com
  • Iris: Settings → Relays → enter wss://nostrbtc.com

For Tor access, use ws://7imqzy3ui3gpn4fdsvefaqjrs4zqvytm33h5jmcmzbfc2hmm4qhy2iad.onion (requires a Tor-enabled client or Tor Browser).

Using the Dashboard

// logging in

The dashboard uses secure Nostr DM authentication:

1

Go to nostrbtc.com/dashboard and enter your npub.

2

Click "Send Login Code". A login code will be sent to your Nostr DMs via encrypted gift wrap (NIP-17).

3

Open your Nostr client, check your DMs from nostrbtc.com, and enter the code.

4

You're in. Your session is saved — you won't need to log in again until you log out.

// this proves you own the npub without ever sharing your private key with anyone.

// dashboard features

  • Live Activity — real-time chart of your events (1H / 6H / 24H / 7D). Click any bar to see individual events.
  • Sync Now — trigger an immediate full sync from all your relays.
  • Nostr Wrapped — your stats at a glance: notes, replies, reactions, zaps, sats earned, top friends with podium ranking.
  • Relay Addresses — copy your clearnet and Tor relay addresses with one click.
  • NIP-05 Identity — claim your [email protected] verified address. Type a name and click Claim.
  • Follow List Backup — see your follow count and download the full list as JSON.
  • Data Backup — broadcast all your events to 6 backup relays, or download everything as a JSON file.
  • Notifications — enable DM notifications for sync status, subscription expiry, and relay downtime alerts.
  • Nostr Card — manage your shareable profile page with custom links. Preview it, copy the URL, share it anywhere.

Features Explained

// auto-sync

nostrbtc maintains persistent WebSocket connections to 7 relays and streams your events in real-time. Post from any relay or client, and your events automatically appear on nostrbtc.com within seconds. On top of that, negentropy sync runs hourly — efficiently reconciling your events with 13 relays so nothing is ever missed.

// nip-05 identity

NIP-05 is a verification standard for Nostr. When you claim [email protected], other users can verify that your npub really belongs to that name. It shows as a purple checkmark in most clients.

To use it: claim a name on your dashboard, then update your Nostr profile's NIP-05 field to [email protected] in your client's profile settings.

// nostr card

Your Nostr Card is a public profile page at nostrbtc.com/p/yourname (or /p/your-npub). It shows:

  • Your avatar, banner, name, and bio from your Nostr profile
  • NIP-05 verification badge
  • Lightning address with one-click zap
  • "Find me on" links to open your profile in popular Nostr clients
  • Up to 10 custom links you configure on your dashboard
  • QR code to follow you on Nostr

Share the URL anywhere — it works like Linktree but pulls data directly from Nostr.

// nostr wrapped

Nostr Wrapped gives you a breakdown of your Nostr activity:

  • Total notes, replies, reactions sent
  • Reactions and zaps received
  • Total sats earned from zaps
  • Top friends — weighted by reactions, reposts, replies, and zaps
  • Activity by hour (when are you most active)
  • Account age and active days

Click "Share Stats Link" to copy a public URL you can share on Nostr.

// dm bot

Manage your subscription entirely through Nostr DMs — no website needed. Send a DM to @northranger with any of these commands:

  • subscribe — get a Lightning invoice for a monthly subscription (2,100 sats)
  • annual — get a Lightning invoice for an annual subscription (21,000 sats)
  • renew — renew your existing subscription (monthly)
  • renew annual — renew for a full year
  • gift npub1... — gift a monthly subscription to someone
  • gift annual npub1... — gift an annual subscription to someone
  • status — check your subscription status and expiry date
  • stats — get your Nostr Wrapped summary (notes, reactions, zaps, top friends)
  • card — get your Nostr Card URL
  • notify on/off — opt in or out of DM notifications (sync status, expiry reminders, relay downtime)
  • help — list all available commands

After you pay the Lightning invoice, your subscription is activated automatically. The bot will confirm via DM.

// the bot uses encrypted Nostr DMs — no email, no accounts, fully native to the protocol.

// notifications

Stay informed about your relay through encrypted Nostr DMs. Enable from your dashboard or by sending notify on to the bot. Works on every device and every client — no app install needed.

You'll be notified about:

  • Sync status — when syncs complete or encounter issues
  • Subscription expiry — reminders to renew your access
  • Relay downtime — alerts if the relay goes down or recovers
  • Payment confirmations — when your Lightning payment is confirmed

Disable anytime from the dashboard or by sending notify off to the bot.

// gift a subscription

Give someone relay access as a gift. The recipient gets everything a subscriber gets — write access, NIP-05 identity, auto-sync, Tor access, and a dashboard.

Two ways to gift:

  • Website: go to nostrbtc.com/subscribe, click the Gift toggle on any plan, enter the recipient's npub, and pay.
  • DM Bot: send gift npub1... (monthly) or gift annual npub1... (annual) to @northranger on Nostr.

The recipient gets a DM notification when their subscription is activated.

// tor access

Every subscriber can connect to the relay via its Tor hidden service. This hides your IP address from the relay and your ISP can't see you're using Nostr. Find the .onion address on your dashboard under "Tor Relay".

Use a Tor-enabled Nostr client, or route your client's traffic through Tor/Orbot.

Security & Privacy

// how login works

nostrbtc never asks for or stores your private key (nsec). Dashboard authentication works through Nostr DMs:

  • You enter your npub (public key only)
  • The server sends a one-time login code to your Nostr DMs
  • You read the code in your Nostr client and enter it on the dashboard
  • This proves you own the npub — only the person who controls the private key can read the DM

Codes expire after 5 minutes and can only be used once.

// what we store

  • Your npub and hex public key (these are public information)
  • Subscription status and expiry date
  • NIP-05 name if you claimed one
  • Custom links for your Nostr Card
  • Your Nostr events (notes, reactions, etc. — all public data from the protocol)

We do not store: private keys, IP addresses, email addresses, passwords, or any personally identifying information.

FAQ

// do I need to subscribe to read from the relay?

No. Reading is free. Anyone can connect to wss://nostrbtc.com and read events. Subscription is only required to write (publish) events.

// can I use nostrbtc as my only relay?

You can, but we recommend using 3-5 relays for redundancy. nostrbtc auto-syncs from your other relays, so your data is always backed up here even if you primarily post elsewhere.

// what happens when my subscription expires?

You lose write access to the relay. Your events remain stored and readable. You can still download backups from other relays where your data was synced. Renew anytime to restore full access.

// I didn't get the login code DM

The login code is sent via NIP-17 (encrypted gift-wrapped DMs). Check your DM inbox from nostrbtc.com. If you don't see it:

  • Make sure your client supports DMs (most do)
  • Check if your client filters DMs from unknown contacts
  • Try clicking "Resend code" on the login page
  • The code expires after 5 minutes — request a new one if needed

// can I change my NIP-05 name?

Yes. Claim a new name from your dashboard. The old name is released and becomes available for others.

// is there a refund policy?

Lightning payments are final and non-refundable. If you have issues, reach out to @northranger on Nostr.

// how do I subscribe via DM?

Send a DM to @northranger on Nostr with the word subscribe (or annual for the yearly plan). You'll receive a Lightning invoice in reply. Pay it and your subscription activates instantly. Send help to see all available commands.

// what NIPs are supported?

The relay supports NIPs: 1, 2, 4, 9, 11, 12, 15, 16, 17, 20, 22, 28, 33, 40, 42, 59, 77. This covers standard notes, encrypted DMs (legacy and gift-wrapped), contact lists, replaceable events, communities, negentropy sync, and more.

// still have questions? DM @northranger on Nostr