fonstr - Run Your Own Nostr Relay in One Line

Why Choose fonstr?

📱

Works on Your Phone

Run a Nostr relay on Android with Termux. Under 90 seconds from zero to running. No other relay can do this.

📖 Beginner's Guide →

⚡

Zero Config

One command and you're done. No config files, no setup scripts, no documentation to read. It just works.

🌐

Web Server Included

Not just a relay. Serve your landing page, build APIs, host static files. Full web server built-in.

🔌

NIP Compliant

NIP-01 (core protocol), NIP-11 (relay info), NIP-98 (HTTP auth). Event filtering, subscriptions, real-time updates.

🚀

Pure JavaScript

No native modules, no compilation, no build tools. Works on Windows, macOS, Linux, Raspberry Pi, and phones.

🔒

Production Ready

HTTPS/WSS support, rate limiting, memory protection. Scale to thousands of connections with confidence.

Quick Examples

Basic

📱 Android

Custom Port

With Landing Page

Production

Basic Relay (10 seconds)

# Run on default port 4444
npx fonstr

# Done! Your relay is live at:
# - Nostr relay: ws://localhost:4444/relay
# - Web server: http://localhost:4444

Run on Android Phone (Under 90 seconds)

First-time setup on your Android phone:

# 1. Install Termux from F-Droid (not Play Store!)
#    Download F-Droid: https://f-droid.org

# 2. Open Termux and update packages
pkg update && pkg upgrade

# 3. Install Node.js
pkg install nodejs-lts

# 4. Run your relay!
npx fonstr

# ✅ Done! Your relay is running on your phone!

Need detailed instructions? Check out our complete step-by-step mobile guide →

Custom Port

# Run on port 8080
npx fonstr 8080

# Or use environment variable
PORT=8080 npx fonstr

With Landing Page

# Create your landing page
mkdir fonstr-data
cat > fonstr-data/index.html << 'EOF'
<!DOCTYPE html>
<html>
<head><title>My Nostr Relay</title></head>
<body>
  <h1>⚡ Welcome to My Relay</h1>
  <p>Connect: ws://localhost:4444/relay</p>
</body>
</html>
EOF

# Start relay
npx fonstr

# Visit http://localhost:4444 to see your page!

Production with HTTPS

# Get SSL certificates (Let's Encrypt)
# Place fullchain.pem and privkey.pem in current directory

# Run with HTTPS
npx fonstr --https --port 443

# Now accessible at wss://yourdomain.com/relay

Run Your Own Nostr Relay
in One Line

Get Started in 10 Seconds

Why Choose fonstr?

Works on Your Phone

Zero Config

Web Server Included

NIP Compliant

Pure JavaScript

Production Ready

Quick Examples

Basic Relay (10 seconds)

Run on Android Phone (Under 90 seconds)

Custom Port

With Landing Page

Production with HTTPS

Ready to Run Your Own Relay?

Run Your Own Nostr Relayin One Line

Get Started in 10 Seconds

Why Choose fonstr?

Works on Your Phone

Zero Config

Web Server Included

NIP Compliant

Pure JavaScript

Production Ready

Quick Examples

Basic Relay (10 seconds)

Run on Android Phone (Under 90 seconds)

Custom Port

With Landing Page

Production with HTTPS

Ready to Run Your Own Relay?

Run Your Own Nostr Relay
in One Line