
BitMagnet Installation Guide | Torrent Search Engine Setup (2025)
π§ BitMagnet Installation Guide (Docker)
π What is BitMagnet?
BitMagnet is a self-hosted, open-source torrent metadata indexer + search engine written in Rust.
It crawls the BitTorrent DHT network, extracts magnet link metadata, and stores it in PostgreSQL + ClickHouse (high-performance databases).
It comes with a web UI + API for searching.
π§ Prerequisites
Make sure you have:
-
Docker installed
-
Docker Compose installed
π If you donβt, follow this Docker installation guide.
π Step 1: Create docker-compose.yml
Inside your project folder:
Paste this config:
π Step 2: Start BitMagnet
Run:
This will:
-
Pull BitMagnet + Postgres images
-
Start both in the background
β Step 3: Verify Installation
Check running containers:
Expected output β youβll see:
-
bitmagnet
on port 3333 -
bitmagnet-postgres
π Step 4: Access Web UI
-
If running locally β open http://localhost:3333
-
If on a remote VPS β make sure port 3333 is allowed in firewall / cloud provider security group.
π― Next Steps
-
Enable ClickHouse (optional, for better performance).
-
Add TMDB API key if you want movie/TV metadata.
-
Reverse-proxy with Nginx + SSL for production.