Max Reseller
Uncategorized

BitMagnet Installation Guide | Torrent Search Engine Setup (2025)

MaxReseller

🧭 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:

nano docker-compose.yml

Paste this config:

services:
bitmagnet:
image: ghcr.io/bitmagnet-io/bitmagnet:latest
container_name: bitmagnet
ports:
# API and WebUI port:
- "3333:3333"
# BitTorrent ports:
- "3334:3334/tcp"
- "3334:3334/udp"
restart: unless-stopped
environment:
- POSTGRES_HOST=postgres
- POSTGRES_PASSWORD=postgres
# Optional: add TMDB API Key if you want movie metadata
# - TMDB_API_KEY=your_api_key
volumes:
- ./config:/root/.config/bitmagnet
command:
- worker
- run
- --keys=http_server
- --keys=queue_server
# Comment the next line if you don’t want DHT crawling
- --keys=dht_crawler
depends_on:
postgres:
condition: service_healthy

postgres:
image: postgres:16-alpine
container_name: bitmagnet-postgres
volumes:
- ./data/postgres:/var/lib/postgresql/data
restart: unless-stopped
environment:
- POSTGRES_PASSWORD=postgres
- POSTGRES_DB=bitmagnet
- PGUSER=postgres
shm_size: 1g
healthcheck:
test: ["CMD-SHELL", "pg_isready"]
start_period: 20s
interval: 10s


πŸš€ Step 2: Start BitMagnet

Run:

docker compose up -d

This will:

  • Pull BitMagnet + Postgres images

  • Start both in the background


βœ… Step 3: Verify Installation

Check running containers:

docker ps

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.

MaxReseller

Leave a Comment

Your email address will not be published. Required fields are marked *

Always Available

24/7 Support

Need Expert Assistance? Our team is ready to help you anytime.

Call us at

+91-853-887-7078

WhatsApp Support

Get instant help through WhatsApp. Our experts are just a message away.

Chat with Us