[{"data":1,"prerenderedAt":325},["ShallowReactive",2],{"blog-\u002Fblog\u002Fnostrfi-relay-0-3-0":3},{"id":4,"title":5,"author":6,"body":7,"date":310,"description":311,"draft":312,"extension":313,"lastReviewed":310,"meta":314,"navigation":315,"owner":6,"path":316,"seo":317,"sitemap":318,"stem":319,"tags":320,"__hash__":324},"blog\u002Fblog\u002Fnostrfi-relay-0-3-0.md","Nostrfi Relay 0.3.0: run a relay as a team, without sharing a key","Nostrfi",{"type":8,"value":9,"toc":300},"minimark",[10,14,31,36,39,55,58,118,121,129,133,148,155,166,170,173,183,186,190,245,252,266,270,282,286],[11,12,13],"p",{},"Nostrfi Relay 0.3.0 is out. It lets the relay's owner give other people\nadministrator rights, so a team can run one relay without passing a private\nkey around. It also stops storing events that Nostr says should not be stored,\nand closes a way that operator signatures could be replayed.",[15,16,18],"callout",{"type":17},"warning",[11,19,20,30],{},[21,22,23,24,29],"strong",{},"Read ",[25,26,28],"a",{"href":27},"#upgrading","how to upgrade"," before you deploy."," This release deletes\nstored ephemeral events on its first start, and it needs to know the relay's\npublic address before it accepts operator requests.",[32,33,35],"h2",{"id":34},"run-a-relay-as-a-team","Run a relay as a team",[11,37,38],{},"Until now, a Nostrfi relay had one operator key. Anyone who moderated the\nrelay or opened the dashboard signed with that key, so a team either shared it\nor left one person to do everything.",[11,40,41,42,45,46,50,51,54],{},"In 0.3.0 the owner can grant the ",[21,43,44],{},"administrator"," role to other pubkeys.\nAdministrators sign in to the dashboard and sign every request with their own\nkey. The owner grants and revokes the role with the NIP-86 ",[47,48,49],"code",{},"assignrole"," and\n",[47,52,53],{},"unassignrole"," methods, from the dashboard or any NIP-86 client.",[11,56,57],{},"What each role can do:",[59,60,61,76],"table",{},[62,63,64],"thead",{},[65,66,67,70,73],"tr",{},[68,69],"th",{},[68,71,72],{},"Owner",[68,74,75],{},"Administrator",[77,78,79,90,99,109],"tbody",{},[65,80,81,85,88],{},[82,83,84],"td",{},"Ban pubkeys and events, block IPs",[82,86,87],{},"Yes",[82,89,87],{},[65,91,92,95,97],{},[82,93,94],{},"Browse stored events and statistics",[82,96,87],{},[82,98,87],{},[65,100,101,104,106],{},[82,102,103],{},"Grant and revoke administrators",[82,105,87],{},[82,107,108],{},"No",[65,110,111,114,116],{},[82,112,113],{},"Read the relay's configuration",[82,115,87],{},[82,117,108],{},[11,119,120],{},"The relay, not the dashboard, decides who may sign in. At sign-in your signer\nasks you to approve twice: once to prove who you are, and once to ask the\nrelay which role your key holds. If you revoke an administrator, the relay\nrefuses their next request and the dashboard signs them out.",[11,122,123,124,128],{},"Administrators are trusted with a lot. They can read every stored event and\nban or block anything. They can't lock the owner out, and the owner can undo\nanything they do. The ",[25,125,127],{"href":126},"\u002Fdocs\u002Frelay\u002Foperations\u002Fmoderation#administrators","administrators","\nsection explains the details, including what to check after you change the\nowner key.",[32,130,132],{"id":131},"ephemeral-events-are-no-longer-stored","Ephemeral events are no longer stored",[11,134,135,136,139,140,143,144,147],{},"Nostr treats kinds ",[47,137,138],{},"20000","–",[47,141,142],{},"29999"," as ephemeral: relays pass them on to\nwhoever is subscribed and are not expected to keep them. Nostrfi Relay used to\nstore them anyway. In production, kind ",[47,145,146],{},"20001"," presence heartbeats were a\nlarge share of the stored rows. They had no value once delivered, and they\nbuilt up a record of when people were online.",[11,149,150,151,154],{},"From 0.3.0 the relay delivers ephemeral events to open subscriptions and never\nwrites them to the database or its backups. On its first start it deletes\nthe ones it stored before. A new metric, ",[47,152,153],{},"relay_events_ephemeral_total",",\ncounts them, so you can still see the traffic.",[11,156,157,158,161,162,165],{},"The relay also refuses NIP-42 authentication events (kind ",[47,159,160],{},"22242",") sent as\nordinary events. They belong in ",[47,163,164],{},"AUTH"," messages, and the relay used to store\nand broadcast them.",[32,167,169],{"id":168},"operator-signatures-are-bound-to-this-relay","Operator signatures are bound to this relay",[11,171,172],{},"Every operator request is signed with NIP-98. The relay used to check only the\npath in the signature, not the host. So a malicious website could ask your\nbrowser extension to sign a request for its own address, at a matching path,\nand replay that signature at your relay. With administrators in this release,\nthat could have granted an attacker a permanent role.",[11,174,175,176,182],{},"In 0.3.0 a signature must name this relay's own address, and each one is\naccepted once. A replayed signature gets the same answer as an unknown key,\nso it doesn't reveal whether the signer holds a role\n(",[25,177,181],{"href":178,"rel":179},"https:\u002F\u002Fgithub.com\u002Fnostrfi\u002Frelay\u002Fissues\u002F60",[180],"nofollow","nostrfi\u002Frelay#60",").",[11,184,185],{},"The release also tightens dashboard sessions. Signing out really ends the\nsession, signing in again ends the previous one, and restarting the dashboard\nends every session.",[32,187,189],{"id":188},"upgrading","Upgrading",[191,192,193,208,230,239],"ol",{},[194,195,196,199,200,203,204,207],"li",{},[21,197,198],{},"Back up first, with your current binary."," The first start of 0.3.0\ndeletes stored ephemeral events. If you want to keep them, take the backup\nwith 0.2.0's ",[47,201,202],{},"-backup",", or copy ",[47,205,206],{},"db\u002Frelay.db"," while the relay is stopped.\nA backup taken with 0.3.0 runs the deletion first.",[194,209,210,213,214,217,218,221,222,225,226,229],{},[21,211,212],{},"Tell the relay its public address."," It now refuses every operator\nrequest, including dashboard sign-in, until it knows its own origin. With\nthe TLS overlay, add ",[47,215,216],{},"RELAY_URL=wss:\u002F\u002Fyour-domain"," to ",[47,219,220],{},".env",". Without the\noverlay, set ",[47,223,224],{},"auth.relay_url"," in ",[47,227,228],{},"config.yaml",".",[194,231,232,238],{},[21,233,234,235],{},"Remove ",[47,236,237],{},"NUXT_ADMIN_PUBKEY"," from the dashboard's environment. The\ndashboard now asks the relay who the owner is.",[194,240,241,244],{},[21,242,243],{},"Sign in again"," after the upgrade. Older sessions don't carry a role.",[11,246,247,248,251],{},"The prebuilt ",[47,249,250],{},"relay-linux-amd64"," binary now needs glibc 2.36 or newer, so it\nruns on Debian 12 and Ubuntu 24.04.",[11,253,254,255,259,260,265],{},"The ",[25,256,258],{"href":257},"\u002Fdocs\u002Frelay\u002Fchangelog","changelog"," has the full list for operators, and\nthe ",[25,261,264],{"href":262,"rel":263},"https:\u002F\u002Fgithub.com\u002Fnostrfi\u002Frelay\u002Freleases\u002Ftag\u002Fv0.3.0",[180],"release notes on GitHub","\nlist every commit.",[32,267,269],{"id":268},"still-true","Still true",[11,271,272,273,276,277,281],{},"The relay still runs as a ",[21,274,275],{},"single instance",", by design. Nostr gets its\nredundancy from clients using several relays, so most operators never need to\nscale one out. Search is still unranked, there is no encryption at rest, and\nTLS belongs to the reverse proxy. The\n",[25,278,280],{"href":279},"\u002Fdocs\u002Frelay\u002Flimitations","current limitations"," page has the full list and the\nreasons.",[32,283,285],{"id":284},"get-it","Get it",[11,287,288,289,293,294,299],{},"New to Nostrfi Relay? The ",[25,290,292],{"href":291},"\u002Fdocs\u002Frelay\u002Fgetting-started\u002Fquickstart","quickstart","\ngets a relay, its dashboard and TLS running with Docker Compose in about ten\nminutes. The source is on ",[25,295,298],{"href":296,"rel":297},"https:\u002F\u002Fgithub.com\u002Fnostrfi\u002Frelay",[180],"GitHub",", and\nissues and questions are welcome there.",{"title":301,"searchDepth":302,"depth":302,"links":303},"",2,[304,305,306,307,308,309],{"id":34,"depth":302,"text":35},{"id":131,"depth":302,"text":132},{"id":168,"depth":302,"text":169},{"id":188,"depth":302,"text":189},{"id":268,"depth":302,"text":269},{"id":284,"depth":302,"text":285},"2026-11-16","Nostrfi Relay 0.3.0 adds administrators, stops storing ephemeral events, and binds every operator signature to the relay it was made for. Here is what changed and how to upgrade.",false,"md",{},true,"\u002Fblog\u002Fnostrfi-relay-0-3-0",{"title":5,"description":311},{"loc":316,"lastmod":310},"blog\u002Fnostrfi-relay-0-3-0",[321,322,323],"nostr relay","release","nostrfi relay","6h1AwOX0Akxds1h3CyhteGHybMd6KEIalh4Lan9hc6Y",1794954745400]