A Nostr keypair — your public key (npub) to configure your relay
NostrKey — browser extension for key management (nostrkey.com)
Once you sign up, we handle the infrastructure: provisioning, TLS certificates, updates, backups, and monitoring. You get a dedicated relay URL and blossom server URL within minutes.
Your Relay
Available
Your NostrKeep relay is a dedicated personal Nostr relay, deployed on edge infrastructure for low latency worldwide.
TLS included — secure WebSocket connections out of the box
Access control — only your public key(s) can publish
Rate limiting — built-in protection against abuse
Persistent storage — your events are stored reliably
Managing Your Relay
From your NostrKeep dashboard you can:
Add or remove authorized public keys
Configure which event kinds your relay accepts
View connection stats and storage usage
Export your data at any time
Personal vs. Shared Relay
By default, your relay is configured for personal use — only your public key can publish events. You can add additional public keys (friends, family, companions) through the dashboard.
Blossom Server Setup
Available
The NostrKeep Blossom server handles media storage — images, video, and files — authenticated via Nostr event signatures.
TLS included — secure file transfers out of the box
Authenticated uploads — only your key(s) can upload
Storage included — generous storage with your plan
How Blossom Works
Files are addressed by their SHA-256 hash (content-addressable)
Uploads require a valid Nostr event signature for authentication
Compatible with any BUD-01 compliant client
Media URLs are stable and shareable
Storage
Your plan includes a generous storage allocation. You can monitor your usage from the NostrKeep dashboard. Need more? Upgrade your plan at any time.
Connecting NostrKey
Once your relay and blossom server are running, point your NostrKey browser extension at your infrastructure.
Add Your Relay
Open NostrKey in your browser
Go to Settings and select your profile
Under Relays, add your personal relay URL:
wss://relay.yourdomain.com
Enable both Read and Write for your relay
Optionally remove or disable public relays you no longer need
Configure Blossom
Nostr clients that support Blossom (BUD-01) will use your server for media uploads when configured. Set your blossom server URL in your client's settings — you'll find your URL in your NostrKeep dashboard.
With both configured, your data flows like this: NostrKey signs events locally in your browser, events go directly to your relay, and media uploads go to your blossom server. Nothing touches third-party infrastructure.
App Server
In Development
The NostrKeep app server provides a web-based management interface for your infrastructure. Monitor your relay, manage storage, and configure settings from your browser.
Planned Features
Relay status dashboard (connected clients, event counts, storage usage)
Blossom storage browser (view, manage, and clean up media files)
Access control management (add/remove allowed public keys)
Backup and restore tools
Log viewer
Common Issues
"WebSocket connection failed"
Verify your relay URL starts with wss:// (not ws://)
Check that your TLS certificate is valid and not expired
Ensure your reverse proxy is forwarding WebSocket connections
Test the connection: wscat -c wss://relay.yourdomain.com
"Event rejected by relay"
Check that your public key is in the relay's allow list
Verify the event kind is accepted by your relay configuration
Ensure the event signature is valid (check NostrKey is signing correctly)
Check relay logs for detailed error messages
"Blossom upload failed"
Verify your blossom server is running and accessible
Check that the upload authorization event is signed by an allowed public key
Ensure you have sufficient disk space on the server
Check file size limits in your blossom configuration
"Clients can't find my relay"
Check DNS resolution: dig relay.yourdomain.com
Ensure port 443 is open in your firewall
Verify the reverse proxy is running
Test from outside your network (NAT/firewall issues are common with home servers)
Service Issues
If you're experiencing service issues that aren't covered above, contact our support team at support@nostrkeep.com. Include your account details and a description of the problem.