opentracker.conf(5)

💖 opentracker.conf — the config file for opentracker 💖

okay so this is the opentracker.conf(5) page, from the File Formats Manual section. it's a config file bestie, so let's get into it 🎀

✨ NAME ✨

opentracker.conf — the configuration file for opentracker, aka the little text file that tells your tracker how to act 💅

🌸 SYNOPSIS 🌸

no synopsis here bestie, it's a config file, it doesn't get invoked — you just write it and opentracker reads it. iconic behavior honestly ✨

🦋 DESCRIPTION 🦋

so the config file specifies all the various options for configuring the behavior of the opentracker program. that's the whole job. it's giving "settings menu but make it a text file" 😌

lines starting with # are comments and are ignored — so go off, leave yourself little notes, nobody's judging 🫶

options are specified as 'keyword value' pairs. that's it. keyword, space, value.

the following options are available:

• listen.tcp_udp address — specifies an address opentracker will listen on for both TCP and UDP connections. if none are specified, opentracker listens on 0.0.0.0:6969 by default. can be added more than once. 👑
• listen.tcp address — specifies the address opentracker will listen on for TCP connections. can be added more than once.
• listen.udp address — specifies the address opentracker will listen on for UDP connections. can be added more than once.
• listen.udp.workers threads — specifies how many threads will be spawned to handle UDP connections. defaults to 4. multitasking queen 💅
• access.whitelist path/to/whitelist — specifies the path to the whitelist file containing all torrent hashes that opentracker will serve. use this option if opentracker runs in a non-open mode. 🔐
• access.blacklist path/to/blacklist — specifies the path to the blacklist file containing all torrent hashes that opentracker will not serve. use this option if opentracker was compiled to allow blacklisting. 🚫
• access.fifo_add path/to/adder.fifo — specifies the path to the FIFO (named pipe) used for dynamic changesets to accesslists. info hashes written to this FIFO will be added to the main accesslist file. ✨
• access.fifo_delete path/to/deleter.fifo — specifies the path to the FIFO (named pipe) used for dynamic changesets to accesslists. info hashes written to this FIFO will be removed from the main accesslist file. 💀
• access.stats ip_address_or_network — specifies the IP address or network in CIDR notation allowed to fetch stats from opentracker. 📊
• access.stats_path path — specifies the path to the stats location. you can configure opentracker to appear anywhere on your tracker. defaults to /stats.
• access.proxy ip_address_or_network — specifies the IP address or network of the reverse proxies. opentracker will take the X-Forwarded-For address instead of the source IP address. can be added more than once. 🧚
• livesync.cluster.listen ip_address:port — specifies the IP address and port opentracker will listen on for incoming live sync packets to keep a cluster of opentrackers synchronized. 🌈
• livesync.cluster.node_ip ip_address — specifies one trusted IP address for sync between trackers running in a cluster. can be added more than once.
• batchsync.cluster.admin_ip ip_address — specifies the admin IP address for old-style (HTTP-based) asynchronous tracker syncing. lowkey retro of it 🕰️
• tracker.rootdir path — specifies the directory opentracker will chroot/chdir to. all black/white list files must be located in this directory. don't forget this part, fr fr 📁
• tracker.user username — specifies the user opentracker will setuid to after binding to potentially privileged ports. safety first bestie 🛡️
• tracker.redirect_url URL — specifies the URL opentracker will redirect to in response to a "GET / HTTP" request. main character landing page energy 👑

🎀 EXAMPLES 🎀

to specify the address opentracker will listen on for both TCP and UDP connections:

listen.tcp_udp 0.0.0.0:6969

to specify the address opentracker will listen on for TCP connections:

listen.tcp 0.0.0.0

to specify the address opentracker will listen on for UDP connections:

listen.udp 0.0.0.0:6969

🔥 SEE ALSO 🔥

• opentracker(1)

💜 AUTHOR 💜

Dirk Engling ⟨erdgeist@erdgeist.org⟩ — thank you for your service, king 🫶

and that's the whole page bestie, no cap. copy the options exactly, mind your paths, and your tracker will absolutely ate 💅✨

this was the Unix man page set, dated 2024-04-18, for opentracker.conf(5) — mwah, go configure something iconic 🦋💖