relay-agent v0.2.0 · MIT · Open Source

Manage your Nostr relay without touching the terminal

Visual dashboard for relay operators — moderation, access control, Lightning payments and multi-relay management in one panel.

BitMacro Relay Manager — Dashboard with relay table, sidebar and status badges

Running a Nostr relay today means...

🖥

Managing whitelists via bash scripts in the terminal

🔍

Inspecting events with CLI (strfry scan, nak req)

🗑

Deleting spam manually by event ID

💰

Implementing paid relay with custom code per installation

No visual tool exists for this. Until now.

Three components. One workflow.

relay-agent
MIT License

Node.js · strfry CLI

Runs on your server

npx @bitmacro/relay-agent
relay-api
Private

Hono · Vercel · Supabase

Central hub + proxy

relay-panel
BSL 1.1

Next.js · Vercel

UI in the browser

Everything you need to run a relay

📊

Visual Dashboard

Events, DB size, uptime, activity by kind

🛡

Access Control

Whitelist/blocklist with toggle, no SSH needed

Lightning Payments

Automatic access after payment, LNbits webhook

🔄

Multi-relay

Manage N relays from one agent instance

🔌

Relay-agnostic

Works with strfry (nostr-rs-relay coming soon)

🔑

GitHub Auth

NextAuth.js v5, no passwords

Up and running in 3 steps

Step 1 — Install the agent
npx @bitmacro/relay-agent
# or
docker pull ghcr.io/bitmacro/relay-agent
Step 2 — Configure RELAY_INSTANCES
[
  { "id": "public", "token": "your-token", "strfryConfig": "/etc/strfry.conf" }
]
Step 3 — Sign in at relay-panel.bitmacro.io and add your relay endpoint

Create a relay in the panel, paste your agent URL and token. Done.

Open Source at the core

relay-agent

MIT License
npx @bitmacro/relay-agent

CI · npm · Docker

GitHub →

relay-panel

BSL 1.1
relay-panel.bitmacro.io

CI · Next.js · v0.2.2

GitHub →

relay-agent is MIT — install it, fork it, contribute. relay-panel source is visible under BSL 1.1.

Start managing your relay today

Free for 1 relay. No credit card. Sign in with GitHub.