Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Configuration (floonet-strfry)

Summary. Two files matter: strfry.conf (the relay itself) and the plugin/authority environment (the Floonet policy). The compose deployment reduces both to one .env.

strfry.conf

The Floonet spec ships a strfry.conf with these keys set; everything else is stock strfry.

KeyFloonet defaultMeaning
relay.info.nameFloonet RelayNIP-11 name; keep it payment-neutral
relay.info.descriptionA strfry Floonet relay.NIP-11 description; same rule
relay.writePolicy.pluginpath to the Floonet pluginThe policy engine; see The write-policy plugin
relay.auth.enabledfalseNIP-42; enable for auth-gated modes
events.maxEventSizelarge enough for gift-wrapped slatepacksDo not shrink; see Gift wraps

Floonet policy environment

The plugin and the bundled name authority read one shared environment (in compose, the .env file):

KeyDefaultMeaning
ALLOWED_KINDS0,3,5,13,1059,10002,10050,27235The whitelist; default deny
FLOONET_PAY_MODEoffoff, name (pay to claim a name), or write (pay to write)
FLOONET_NAME_PRICE_GRINunsetPrice of a name in GRIN when FLOONET_PAY_MODE=name
GOBLINPAY_URLunsetYour GoblinPay server, required for any paid mode
GOBLINPAY_TOKENunsetGoblinPay API token; keep it out of the repo, mount it 0400

The full key table for both packages lives in the config keys reference.

The one-file experience

In the compose deployment, .env.example documents every key above with comments. Turning on paid names is three edits:

FLOONET_PAY_MODE=name
FLOONET_NAME_PRICE_GRIN=5
GOBLINPAY_URL=https://pay.yourdomain

See Charge GRIN for your relay for the walkthrough.