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

``bash


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

$3

`bash
npx fastpod
`

$3

`bash
npm install -g fastpod
fastpod
`

🎮 Usage

`bash


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
`bash
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"