LNbits Nostr Relay Manager — strfry and a management UI in one Docker container.
Manage author and word lists, retention, publish limits, traffic, disk space and optional background AI moderation. Sign in with a Nostr extension. Includes light/dark themes and 10 languages with browser-language detection.
Requires Docker with Compose. These steps create a new relay; for an existing database, read migration instructions first.
git clone https://github.com/lnbits/aedos_strfry.git
cd aedos_strfry
cp .env.example .envEdit .env, replacing the example npub with your public key:
ADMIN_NPUBS=npub1your_actual_public_key
PUBLIC_ORIGIN=http://localhost:3000
RELAY_URL=ws://localhost:7777
AI_MODERATION_ENABLED=falsedocker compose build --pull
docker compose run --rm -T setup </dev/null
docker compose up -d --no-buildOpen http://localhost:3000 on the Docker host and connect your Nostr extension, such as nos2x. The relay listens on port 7777. For a public server, configure your HTTPS/WSS addresses and reverse proxy.
Events live in ./strfry-db/; settings live in ./data/. Keep both directories and .env when updating.
- Retention:
0keeps events forever. A finite period enables rolling cleanup. - Publish limits: 60/minute and 1,000/hour per author. Set both to
0in Rate limits for unrestricted publishing. - AI: the setup above locks it off, including for admins. See the security review before enabling media review.
Saved policies survive restarts and updates.
| Task | Command |
|---|---|
| Logs | docker compose logs -f aedos |
| Stop | docker compose down |
Start or apply .env changes |
docker compose up -d --no-build aedos |
For more admins, add comma-separated public npubs to ADMIN_NPUBS, then apply the .env changes. This briefly restarts the relay; every listed admin has full management access.
To update, keep your existing .env and storage:
git pull
docker compose build --pull
docker compose up -d --no-buildBack up both data directories with the container stopped. Never run two relay deployments against the same database.
Deployment, backups and migration · Policy and feature reference · Development and tests · Environment options · Security review