Lighthouse Documentation

Self-hosted Nostr indexer for NIP-35 torrent events with federated curation

View the Project on GitHub gmonarque/lighthouse

Lighthouse

Self-hosted Nostr indexer for NIP-35 torrent events with federated curation.

Lighthouse replaces centralized torrent indexing websites with a censorship-resistant, community-governed alternative based on cryptographic trust.


Key Features


Why Lighthouse?

The Problem

BitTorrent excels at file transport but lacks native content discovery. Historically, centralized indexing websites filled this gap, creating significant issues:

The Solution

Lighthouse uses the Nostr protocol as a global, censorship-resistant message bus. NIP-35 allows encapsulating torrent metadata in cryptographically signed events.

The Web of Trust model replaces centralized moderation with distributed curation:

Actor Role
Emitter Signs and publishes torrent metadata
Curator Validates emitters, maintains follow lists
User Subscribes to trusted curators

Section Description
Getting Started 5-minute quick start guide
Installation Detailed installation instructions
Configuration Configuration reference
Architecture System design and components
API Reference REST and Torznab API documentation
Web of Trust Trust system deep dive
Curation Curator setup and ruleset guide
Federation Multi-instance deployment
Development Contributing guide

Disclaimer

This software is a Nostr protocol indexer that reads publicly available NIP-35 events from Nostr relays. It does not host, distribute, or provide access to any copyrighted content. The software merely indexes metadata published on the decentralized Nostr network. Users are solely responsible for their use of this software and must comply with all applicable laws in their jurisdiction.


License

MIT License - See LICENSE