bitmagnet
A self-hosted BitTorrent indexer and DHT crawler that organizes torrent metadata into a searchable database with a web UI and API.
Smart Download
Download Download Version
v0.10.0 · 16.9 MB
Self-host your own torrent search engine with automatic DHT crawling and Servarr integration.
Core Features
- Automatic DHT network crawling for torrent discovery
- Metadata classification (movies, TV, music, etc.)
- Web UI for searching and filtering
- GraphQL API for integration
- Native Servarr stack support (Sonarr, Radarr, etc.)
What It Can't Do
- •Requires a stable network with port forwarding for DHT; initial crawl may consume significant disk space (several GB+); be aware of copyright laws in your jurisdiction.
Use Cases
- Create your own private torrent index independent of public sites
- Automate media downloads with Sonarr/Radarr using bitmagnet as a custom indexer
Detailed Introduction
bitmagnet is a self-hosted tool that crawls the BitTorrent DHT network to discover torrents, then classifies and indexes their metadata (titles, categories, sizes, etc.) into a PostgreSQL database. It provides a modern web UI for searching and filtering torrents, plus a GraphQL API for integration. It also integrates directly with the Servarr stack (Sonarr, Radarr, Lidarr, etc.), acting as a custom indexer for automated media downloads. Unlike public trackers, bitmagnet gives you full control over your own search index without relying on third-party sites.
Troubleshooting & FAQ (2)
TroubleshootingWhy does Bitmagnet Docker container fail to resolve DNS with 'nameserver 127.0.0.1'?
This occurs when using network_mode: service:gluetun (or similar) because the container inherits DNS settings from the VPN service, which might be set to a non‑working localhost resolver. Fix: manually edit /etc/resolv.conf inside the Bitmagnet container to use a public DNS (e.g., nameserver 9.9.9.9), Docker will preserve the change. Alternatively, add dns: 9.9.9.9 to the Bitmagnet service in your compose file.
TroubleshootingHow can I automatically delete torrents with no seeders in Bitmagnet?
You can use the classifier system with a CEL condition. Create a classifier rule that matches torrent.seeders == 0 and set the action to delete. Add this to your classifier configuration. Be aware that seeder counts are estimates; deleting based solely on this value may remove healthy torrents. Reference the protobuf schema (bitmagnet.proto) for available fields like seeders and leechers.
Tags
Getting Started
Download installer
Click the button above to download the installer for your system
Install the software
Double-click the downloaded installer and follow the prompts
Step 1: Install Docker and Docker Compose
Step 2: Download the official docker-compose.yml from the website
Step 3: Run docker-compose up -d to start services
- Step 1: Install Docker and Docker Compose
- Step 2: Download the official docker-compose.yml from the website
- Step 3: Run docker-compose up -d to start services
Checksum not available
This project has not published a SHA-256 checksum on its GitHub Release page
SHA256 Checksum
No checksum available
Download directly from GitHub Releases and verify file integrity yourself
All SHA-256 checksums on this platform are extracted from the project's official GitHub Release page, without any modification. You can independently verify them on the GitHub Releases page.
Open Source Transparency
View GitHub SourceUninstall Info
Stop containers and remove volumes: docker-compose down -v, then delete the project folder.
No Extra Dependencies
Ready to use after download. No additional runtime required.
Having issues? Check the FAQ below
2 FAQs
Similar Projects
copyparty
copyparty turns any device into a file server with resumable uploads/downloads using any web browser. Supports HTTP, WebDAV, SFTP, FTP, TFTP, SMB. Only requires Python (2 or 3).
Paperless-ngx
An open-source document management system that turns physical papers into a searchable, organized digital archive. Self-hosted, OCR-powered, and built to eliminate paper clutter forever.
Nextcloud Server
Nextcloud Server is a free, self-hosted productivity platform that puts you in control of your files, contacts, calendars, and communication.