binhex-bitmagnet

binhex-bitmagnet

Docker app from Binhex's Repository

Overview

A self-hosted BitTorrent indexer, DHT crawler, content classifier and torrent search engine with web UI, GraphQL API and Servarr stack integration.

Application

bitmagnet

Description

A self-hosted BitTorrent indexer, DHT crawler, content classifier and torrent search engine with web UI, GraphQL API and Servarr stack integration.

Build notes

Latest GitHub release.

Usage

docker run -d \
    --name=<container name> \
    -p <webui port>:3333 \
    -p <bittorrent port tcp>:3344 \
    -p <bittorrent port udp>:3344/udp \
    -p <postgres port>:5432 \
    -v <path for config files>:/config \
    -v /etc/localtime:/etc/localtime:ro \
    -e TMDB_API_KEY=<tmdb key> \
    -e PROCESSOR_CONCURRENCY=<int> \
    -e POSTGRES_VACUUM_DB=<true|false> \
    -e POSTGRES_REINDEX_DB=<true|false> \
    -e HEALTHCHECK_COMMAND=<command> \
    -e HEALTHCHECK_ACTION=<action> \
    -e HEALTHCHECK_HOSTNAME=<hostname> \
    -e UMASK=<umask for created files> \
    -e PUID=<uid for user> \
    -e PGID=<gid for user> \
    binhex/arch-bitmagnet

Please replace all user variables in the above command defined by <> with the correct values.

Access application

http://<host ip>:3333

Example

docker run -d \
    --name=bitmagnet \
    -p 3333:3333 \
    -p 3344:3344 \
    -p 3344:3344/udp \
    -p 5432:5432 \
    -v /apps/docker/bitmagnet:/config \
    -v /etc/localtime:/etc/localtime:ro \
    -e UMASK=000 \
    -e PUID=0 \
    -e PGID=0 \
    binhex/arch-bitmagnet

Notes

User ID (PUID) and Group ID (PGID) can be found by issuing the following command for the user you want to run the container as:-

id <username>

If you appreciate my work, then please consider buying me a beer :D

PayPal donation

Documentation | Support forum

Install binhex-bitmagnet on Unraid in a few clicks.

Find binhex-bitmagnet in Community Apps on your Unraid server, review the template, and click Install. Unraid handles the Docker app or plugin setup from the published template.

Open the Apps tab on your Unraid server Search Community Apps for binhex-bitmagnet Review the template variables and paths Click Install

Download Statistics

15,907
Total Downloads
921
This Month
1,084
Avg / Month

Total Downloads Over Time

Loading chart...

Related apps

Explore more like this

Explore all

Details

Repository
ghcr.io/binhex/arch-bitmagnet
Last Updated2025-12-28
First Seen2024-09-13

Runtime arguments

Web UI
http://[IP]:[PORT:3333]
Network
bridge
Shell
bash
Privileged
false
Extra Params
--restart=unless-stopped

Template configuration

Port: Web InterfacePorttcp

This is the Web UI port for the application.

Target
3333
Default
3333
Port: Bittorrent TCPPorttcp

This is the bittorrent TCP port used by the application.

Target
3344
Default
3344
Port: Bittorrent UDPPortudp

This is the bittorrent UDP port used by the application.

Target
3344
Default
3344
Port: PostgresPorttcp

This is the port for Postgres, this is optional.

Target
5432
Default
5432
Path: /configPathrw

This is the container path to your configuration files, e.g. databases, configuration files, logs etc.

Target
/config
Default
/mnt/user/appdata/bitmagnet
Variable: POSTGRES_BACKUP_DBVariable

Enable or disable automatic database backup on container start.

Target
POSTGRES_BACKUP_DB
Default
false|true
Variable: POSTGRES_BACKUP_RETENTION_DAYSVariable

Number of days to retain database backups. Older backups will be automatically deleted.

Target
POSTGRES_BACKUP_RETENTION_DAYS
Default
7
Variable: POSTGRES_SCHEDULED_BACKUPVariable

Enable or disable scheduled database backups.

Target
POSTGRES_SCHEDULED_BACKUP
Default
false|true
Variable: POSTGRES_SCHEDULED_BACKUP_INTERVAL_HOURSVariable

Interval in hours between scheduled database backups.

Target
POSTGRES_SCHEDULED_BACKUP_INTERVAL_HOURS
Default
48
Variable: POSTGRES_RESTORE_DBVariable

Enable or disable database restore on container start. This will drop and recreate the database.

Target
POSTGRES_RESTORE_DB
Default
false|true
Variable: POSTGRES_RESTORE_PATHVariable

Path to backup directory to restore from, e.g. '/config/bitmagnet/backups/bitmagnet_20251218_174202'. If not specified, the latest backup will be used.

Target
POSTGRES_RESTORE_PATH
Variable: POSTGRES_VACUUM_DBVariable

Enable or disable database vacuuming for BitMagnet.

Target
POSTGRES_VACUUM_DB
Default
false|true
Variable: POSTGRES_REINDEX_DBVariable

Enable or disable database reindexing for BitMagnet.

Target
POSTGRES_REINDEX_DB
Default
false|true
Variable: TMDB_API_KEYVariable

Specify your TMDB API key, if you do not specify your own key then a default key will be used which may result in slower indexing due to rate limiting.

Target
TMDB_API_KEY
Variable: PROCESSOR_CONCURRENCYVariable

Defines the maximum number of torrents to be processed/classified simultaneously. The default setting of 1 aims to support the widest range of systems. Increasing the setting (for example to 3) may improve throughput of the processor queue but is known to cause slowdowns on less powerful systems.

Target
PROCESSOR_CONCURRENCY
Default
1
Variable: ENABLE_HEALTHCHECKVariable

Enable or disable healthchecks.

Target
ENABLE_HEALTHCHECK
Default
yes|no
Variable: HEALTHCHECK_COMMANDVariable

The command or script to execute, if not specified then the script healthcheck.sh will be used (process, dns and https checking).

Target
HEALTHCHECK_COMMAND
Variable: HEALTHCHECK_ACTIONVariable

The action to execute if the healthcheck command returns a non zero exit code, if not specified the action will be 'exit 1', if you want the container to exit on failure then set the action to 'kill 1'.

Target
HEALTHCHECK_ACTION
Variable: HEALTHCHECK_HOSTNAMEVariable

The hostname used when performing HTTPS and DNS healthchecking.

Target
HEALTHCHECK_HOSTNAME
Default
google.com
Variable: PUIDVariable

User ID for the running container

Target
PUID
Default
99
Variable: PGIDVariable

Group ID for the running container

Target
PGID
Default
100
Variable: UMASKVariable

UMASK for the running container

Target
UMASK
Default
000