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

Self-hosting overview

Summary. Goblin’s public infrastructure (the goblin.st name authority, the Goblin relay, and a Nym network requester) is all run-your-own. None of it is a hard dependency: you can point a Goblin wallet at your own name authority, your own relay, and your own mixnet exit, and build the app from source.

Why self-host

Defaults are conveniences, not gatekeepers. Running your own pieces gives you:

  • Independence: your community isn’t reliant on one operator for names or relaying.
  • A smaller metadata footprint: your users’ name lookups and messages stay on infrastructure you control.
  • Federation: your name authority issues name@yourdomain, and Goblin can be told to treat it as home.

The pieces

ServiceWhat it doesGuide
Name authority (goblin-nip05d)Issues names, resolves NIP-05, NIP-98 authRun a name authority
Relay (strfry + write policy)Carries the encrypted payment messagesRun a relay
Nym network requesterThe mixnet exit Goblin egresses throughRun a Nym network requester
The app itselfBuild for desktop / AndroidBuilding Goblin

Pointing a wallet at your infra

  • Name authority: Settings → Identity → Name authority → set your domain. Bare names then resolve against it.
  • Relays: Settings → Nostr Relays → add your wss://… and save & reconnect.
  • Mixnet exit: set the GOBLIN_NYM_PROVIDER environment variable to your requester’s address (see the client).

These docs keep deployment generic. Adapt paths, domains, and certificates to your own host; don’t copy another operator’s production specifics.