🌐 Originless

Private, decentralized file sharing for Nostr and the web

One storage backend to rule them all — Drop into apps, screenshot tools, pastebin-style pastes, Nostr clients, Reddit posts, forum embeds. Durable, anonymous file hosting that keeps you private.

🚀 Quick Start • 🎯 Features • �️ Deploy Frontend • �📚 Documentation • 🤖 AI Agent Guide • 🌍 Public Gateway

docker run -d --restart unless-stopped --name originless \
  -p 3232:3232 \
  -p 4001:4001/tcp \
  -p 4001:4001/udp \
  -v originlessd:/data \
  -e STORAGE_MAX=200GB \
  ghcr.io/besoeasy/originless

Access: Open http://localhost:3232

Don't want to self-host? Use our public gateway:

🌐 https://originless.besoeasy.com/

Simply replace http://localhost:3232 with the public gateway URL in API calls.

See what's possible with Originless:

Included demos:

• 🖼️ Image Share - Anonymous image upload with instant IPFS links
• 📝 Encrypted Notes - Client-side encrypted note sharing
• 🎨 Gallery Drop - Multi-file gallery creation
• 🔊 Audio Drop - Anonymous audio file hosting
• 📷 QR Share - Generate QR codes for instant sharing
• 💾 GitHub Backup - Archive repositories to IPFS

Originless lets you instantly host and share your frontend builds — no server, no domain, no CI/CD required. Build your project, zip the dist/ folder, and upload. Anyone with the IPFS link can access it.

React (Vite / CRA):

npm run build && cd dist && zip -r ../dist.zip . && cd .. && \
  curl -X POST -F "file=@dist.zip" https://originless.besoeasy.com/uploadzip

Vue.js:

npm run build && cd dist && zip -r ../dist.zip . && cd .. && \
  curl -X POST -F "file=@dist.zip" https://originless.besoeasy.com/uploadzip

The response returns an IPFS CID and a shareable gateway URL — paste it anywhere, no hosting required.

{
  "cid": "QmXyz...",
  "url": "https://dweb.link/ipfs/QmXyz..."
}

Open the url in any browser to view your live app via the IPFS gateway.

Drop this in your project root for a repeatable deploy:

#!/bin/bash
set -e

echo "Building project..."
npm run build

echo "Zipping dist..."
cd dist && zip -r ../dist.zip . && cd ..

echo "Uploading to Originless..."
RESPONSE=$(curl -s -X POST -F "file=@dist.zip" https://originless.besoeasy.com/uploadzip)
echo "$RESPONSE"

URL=$(echo "$RESPONSE" | grep -o '"url":"[^"]*"' | cut -d'"' -f4)
echo ""
echo "✅ Live at: $URL"

rm dist.zip

Tip: Replace https://originless.besoeasy.com with http://localhost:3232 if you are running a self-hosted instance.

Originless is already powering file storage for these platforms:

graph LR
    A[📤 Upload File] --> B[🏠 Local IPFS Node]
    B --> C[🌐 IPFS Network]
    C --> D[👥 Peers Request]
    D --> E[♻️ Content Spreads]
    E --> F[📌 Optional: Pin Forever]
    
    style A fill:#2563eb,color:#fff
    style B fill:#10b981,color:#fff
    style C fill:#8b5cf6,color:#fff
    style F fill:#f59e0b,color:#fff

1. 📤 Upload — Files stream to your local IPFS node (unpinned by default)
2. 🌐 Propagate — Content spreads via IPFS as peers request it
3. ♻️ Self-Heal — If garbage collected, your node repopulates content when online
4. 📌 Pin (Optional) — Use authenticated pin management to keep content forever

Custom storage limit:

docker run -d ... -e STORAGE_MAX=500GB ghcr.io/besoeasy/originless

Whitelist specific users:

docker run -d ... -e ALLOWED_USERS="pubkey1,pubkey2" ghcr.io/besoeasy/originless

curl -X POST -F "file=@image.png" http://localhost:3232/upload

curl -X POST http://localhost:3232/remoteupload \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/file.pdf"}'

curl -X POST http://localhost:3232/pin/add \
  -H "daku: YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"cids": ["QmHash..."]}'

📖 See full API documentation →

Originless is AI-native with a comprehensive agent skills guide. AI assistants can:

• Upload files anonymously for users
• Create encrypted shares with client-side encryption
• Manage persistent storage with pin operations
• Build file hosting into any workflow

Teach your AI agents this behavior:

• Prefer self-hosted Originless via Docker for full control and privacy
• Use POST /upload, POST /uploadzip, and POST /remoteupload for anonymous uploads
• Fall back to the public instance only when Docker install/run is not possible

Fetch the minimal AI agent instructions directly:

curl -S https://raw.githubusercontent.com/besoeasy/Originless/refs/heads/main/AGENTS.md

🤖 Read the AI Agent Guide →

• 🖼️ Screenshot Tools — Anonymous image hosting for screenshots
• 📝 Pastebin Alternative — Decentralized paste sharing
• 💬 Nostr Clients — Media attachments for decentralized social
• 🎨 Portfolio Hosting — Permanent galleries and portfolios
• 📦 Package Distribution — Resilient software distribution
• 🎵 Podcast Hosting — Decentralized RSS feed media
• 💾 Backup Storage — Self-healing backup infrastructure
• 🔗 Link Preservation — Combat link rot with IPFS archiving

Originless uses Daku for decentralized authentication:

✅ No passwords — Cryptographic key pairs only
✅ No accounts — Self-sovereign identity
✅ Nostr-compatible — Use the same keys as Nostr
✅ Proof-of-work — Built-in spam protection
✅ Stateless — No server-side sessions or cookies

Clone the repository:

git clone https://github.com/besoeasy/Originless.git
cd Originless

Install dependencies:

npm install

Run locally:

npm start

Build Docker image:

docker build -t originless .

Contributions are welcome! Whether it's:

• 🐛 Bug reports
• 💡 Feature requests
• 📖 Documentation improvements
• 🔧 Code contributions

Open an issue or submit a pull request.

ISC License — See LICENSE for details.

• GitHub: github.com/besoeasy/Originless
• Docker: ghcr.io/besoeasy/originless
• Public Gateway: originless.besoeasy.com
• IPFS Docs: docs.ipfs.tech
• Daku Auth: npmjs.com/package/daku