NostrDeploy

Deploy and host static websites using the Nostr protocol and Blossom servers. Decentralized, censorship-resistant, and zero-storage hosting.

📖 View NIP Specification 🚀 Deploy CLI Tool

Why NostrDeploy?

🌐

Decentralized Hosting

Your website files are stored on Blossom servers and indexed via Nostr events. No single point of failure or censorship.

🔒

Cryptographic Security

All file mappings are cryptographically signed with your Nostr private key. Only you can update your site.

💾

Zero Local Storage

This server acts as a pure gateway - no files are stored locally. Everything is retrieved from the decentralized network.

⚡

Intelligent Caching

Smart in-memory caching with TTL ensures fast loading times while maintaining data freshness.

🔗

Npub Subdomains

Access any site using npub subdomains: npub1xyz.nostrdeploy.com Clean, memorable URLs for the decentralized web.

🛡️

Built-in Protection

Rate limiting, security headers, graceful error handling, and automatic fallbacks keep your sites running smoothly.

How It Works

1

Publish Files

Upload your static site files to Blossom servers and publish path mappings as Nostr events (kind 34128). Use our CLI tool for easy deployment.

2

Request Site

Visitor accesses your site via npub subdomain. Server resolves your public key from the subdomain.

3

Fetch Mappings

Server queries Nostr relays for your file path mappings and Blossom server preferences.

4

Serve Content

Files are retrieved from Blossom servers using SHA256 hashes and served with proper headers and caching.

Quick Start Guide

Deploy your first decentralized website with just a single command.

2

Run the fast deploy command

cd my-website
npx -y nostr-deploy-cli deploy --skip-setup
3

Access Your Site

https://npub1xyz.nostrdeploy.com

📁 Example: Deploying a Simple Website

Your Local Files:

my-website/
├── index.html
├── about.html
├── css/
│ └── style.css
├── images/
│ └── logo.png
└── 404.html

Live URLs:

index.html → /
about.html → /about
css/style.css → /css/style.css
images/logo.png → /images/logo.png
404.html → fallback page
💡 How It Works Behind the Scenes:

Your files are uploaded to Blossom servers, and their paths are mapped via signed Nostr events. When someone visits your site, this server fetches the mapping from Nostr relays and serves the files from Blossom.

Ready to deploy your decentralized website?

🚀 Get Started with CLI Tool