udpt/README.md

UDPT

UDP-Tracker is a torrent tracker that implements BEP15, the UDP torrent tracker protocol.

The UDP tracker protocol is light compared to HTTP(s) based torrent trackers since it doesnt have TCP's overhead.

This project was developed with simplicity and security in mind. Development started November 20th, 2012 by @naim94a.

Features

• UDP torrent tracking server
• SQLite3 database, with in-memory support (volatile)
• Choice of static or dynamic tracker modes
• HTTP REST API
• Logging
• Windows Service / Linux Daemon
• INI like configuration syntax

Getting Started

The easiest way is to download binaries from the Releases Section, but releases don't get updated as often as the master branch...

Getting the code

1. Make sure you have the following binaries, they are required to build UDPT: All packages should be in most linux disto's official repositories

   • cmake
   • make
   • g++, gcc, ld
   • boost_program-options, boost_system
   • libsqlite3
   • libevent
   • gtest - optional

2. Obtain the code: git clone https://github.com/naim94a/udpt.git

3. And start building!

   cd udpt
   mkdir build && cd build
   cmake ..
   make udpt
   

4. Finally, start the server:

   ./udpt -ic ../udpt.conf
   

   Now you can get people to use your tracker at: udp://<YOUR_IP>:6969/

You should note that the default configuration does not use a persistent database.

Docker image

There is an official UDPT Docker image on Docker Hub, built from source automatically on each commit using an Automated Build.

Links

• UDPT's documentation can be found in the docs directory, or the rendered version at naim94a.github.io/udpt.
• If you have any suggestions or find any bugs, please report them here: https://github.com/naim94a/udpt/issues
• Project Page: http://www.github.com/naim94a/udpt

How to Contribute

Issues, Pull-Requests and suggestions are welcome as well. See our CONTRIBUTING page for more information.