fastpod

The fastest way to run a Solid pod. Zero configuration, just works.

fastpod is the quickest way to get your own Solid pod server running.

🚀 Quick Start

# Run instantly with npx (no installation required!)
npx fastpod

# That's it! Your Solid pod is running at http://localhost:5444

⚡ Performance

fastpod lives up to its name. Here are real benchmark results:

🏁 Benchmark Results
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  Startup Time:        ~3 seconds
  First Response:      3ms

  Average Response Times:
    GET:     0.63ms
    PUT:     0.84ms
    POST:    0.64ms
    DELETE:  0.44ms

  Throughput:          1,569 requests/sec
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

What this means:

• 🚀 Server starts in ~3 seconds from npx fastpod
• ⚡ Sub-millisecond response times for all operations
• 💪 Handles 1,500+ requests per second
• 🎯 Production-ready performance out of the box

✨ Features

• ✅ Zero configuration - Just works
• ✅ Lightning fast - Server starts in seconds
• ✅ Solid Protocol - Full spec compliance
• ✅ WebID Authentication - Decentralized identity
• ✅ Passkey Support - Modern passwordless auth
• ✅ WebSocket Notifications - Real-time updates
• ✅ JSON-LD Native - First-class linked data support

📦 Installation

No Installation (Recommended)

npx fastpod

Global Installation

npm install -g fastpod
fastpod

🎮 Usage

# Start with defaults
fastpod

# Custom port
fastpod --port 8080

# Custom data directory
fastpod --root /var/pods

# Multi-user mode
fastpod --multiuser

# Disable authentication
fastpod --no-auth

# Show help
fastpod --help

📖 How It Works

fastpod is a lightweight wrapper around jspod, which provides a beautiful CLI for JavaScriptSolidServer.

Stack:

fastpod → jspod → JavaScriptSolidServer

Each layer adds value:

• JavaScriptSolidServer: Full-featured Solid server implementation
• jspod: Beautiful CLI with sensible defaults
• fastpod: Fastest, easiest way to get started

🌟 First Run

Step 1: Run the command

npx fastpod

Step 2: Open http://localhost:5444 in your browser

Step 3: Register with your device's passkey (fingerprint, Face ID, etc.)

Step 4: Start using your pod!

🎯 Why fastpod?

• Fast to type: Just 7 characters (fastpod)
• Fast to start: Server ready in 3 seconds
• Fast to respond: Sub-millisecond response times (0.44-0.84ms)
• Fast to scale: 1,500+ requests/second throughput
• Fast to learn: Zero configuration needed
• Fast to deploy: One command and you're live

📚 Learn More

• Solid Project: https://solidproject.org
• Solid Protocol: https://solidproject.org/TR/protocol
• WebID: https://www.w3.org/2005/Incubator/webid/spec
• jspod: https://github.com/JavaScriptSolidServer/jspod

🤝 Contributing

Contributions welcome! This package is intentionally minimal - just a friendly wrapper.

📄 License

MIT - see LICENSE

🙏 Credits

Built on jspod and JavaScriptSolidServer.

Made with ❤️ for the Solid community

"Your pod, fast"