Home

Welcome to the bitmagnet fork wiki. This is a stability-hardened community fork of bitmagnet-io/bitmagnet — a self-hosted BitTorrent indexer, DHT crawler, content classifier and torrent search engine.

The fork extends upstream with stability fixes, Prowlarr integration, bulk database import, RSS feed ingestion, OMDb and ThePornDB enrichment, DB size management, and VPN-friendly sidecar deployments. It ships as a ready-to-deploy Docker image built automatically on every push to main.

ghcr.io/o51r15/bitmagnet:latest

This fork is not affiliated with the upstream project.

---

Getting started

• Installation — Docker Compose setup, environment variables, config.yml
• FAQ — common questions about DHT crawling, classification, and search
• Worker Keys — which workers to enable for different use cases

Deployment

• Gluetun VPN Deployment — single-compose and split-sidecar topologies
• DHT Sidecar Setup — running the DHT crawler behind a VPN in a separate container
• Postgres Tuning — RAM-based sizing for different hardware

Feature guides

• Prowlarr Integration — connecting Prowlarr, indexer selection, network setup
• OMDb Enrichment — Rotten Tomatoes scores, Metacritic, awards, API key setup
• DB Size Management — configurable per-source trim, dry run, Prowlarr protection
• Content Classification — TMDB/OMDb pipeline, classifier flags
• Database Import - import CSV/NDJSON/SQL/SQLite dumps through the web UI
• RSS Feeds - scheduled RSS/Torznab feed ingestion
• ThePornDB Classification - adult content classification

Reference

• Fork Changes — full list of what differs from upstream
• Troubleshooting — common startup failures, log reading, ExitCode meanings
• Roadmap — planned features and known issues