Public | Automated Build

Last pushed: 2 years ago
Short Description
Full-featured BitTorrent box run on Docker
Full Description

docktorrent

Using Docker,
rTorrent and
ruTorrent to run a full-featured
BitTorrent box.

Highlights

  • All-in-one Docker container, build once and run everywhere.
  • Newest version of rTorrent and ruTorrent, with support of DHT and
    asynchronous DNS which will result in a more responsive rTorrent.
  • Enable all useful ruTorrent plugins by default.
  • Get a working BitTorrent box in less than 3 minutes, give it a quick try
    and tune the configs later.
  • rTorrent will automatically restarts on crash or freeze.
  • No more boring installation, also keep your OS in a clean state.

Quick Start

Clone this repository and build the image locally:

git clone https://github.com/kfei/docktorrent
cd docktorrent
docker build -t docktorrent .

The building process may take some time. You can just pull the latest image
from mine:

docker pull kfei/docktorrent

After the image is built or pulled, run the docktorrent container, for example:

docker run -it \
    -p 80:80 -p 45566:45566 -p 9527:9527/udp \
    --dns 8.8.8.8 \
    -v /data-store:/rtorrent \
    -e UPLOAD_RATE=1024 \
    docktorrent

Note that:

  • The exposed ports are required for ruTorrent web interface, rTorrent
    listening and the DHT protocol according to the default .rtorrent.rc.
  • The --dns 8.8.8.8 argument is optional but recommended. It seems like the
    current version of rTorrent still has some DNS
    issues
    , using Google's
    DNS may help.
  • The /data-store volume is for all downloads, torrents and session data,
    just make sure the disk space is enough.
  • Override the upload_rate setting of rTorrent to 1024KB. Check the full list of
    available runtime configs.

If the container starts without errors, visit http://127.0.0.1 through any web
browser, log in to with the default username/password: docktorrent/p@ssw0rd.

Happy seeding!

Runtime Configs

There are some environment variables can be supplied at run time:

  • LOGS_OFF: Set this to yes to turn off all logs generated by rTorrent
    and other services so that you don't have to worry about space for
    /var/log. Default is not set.
  • AUTH_OFF: Disable HTTP authentication on certain network. E.g.,
    192.168.1.0/24 or all.

Override settings in .rtorrent.rc:

  • IP overrides ip.
  • MAX_PEERS overrides max_peers.
  • MAX_PEERS_SEED overrides max_peers_seed.
  • MAX_UPLOADS overrides max_uploads.
  • DOWNLOAD_RATE overrides download_rate.
  • UPLOAD_RATE overrides upload_rate.

Requirement

All you need is to have Docker installed on your system. Check Docker
Documentation for installation guide on
your OS platform.

Tips

  • docker stop can gracefully shutdown rTorrent if you give it more time by
    docker stop -t 120 (which means 120 seconds to time out).

Feedback

Bug reports and feature suggestions are both welcome. Feel free to use the
issue tracker.

Screenshots

Docker Pull Command
Owner
zl4bv
Source Repository

Comments (0)