rartracker
A modern front and backend bittorrent tracker written in AngularJS and PHP.
Current version
0.3.2
Author
the swedish torrent king
Feature highlights
- Super responsive GUI thanks to the SPA-application nature of AngularJS
- Advanced admin-features for monitoring site activity, handling reports and multi-deleting torrents.
- Many features suitable for scene only trackers
- Awesome features like bonus-system, leech bonus, seed-time, request system and rss-system.
- Highly skinnable and mobile friendly design with Bootstrap CSS
- Very clean code to grasp for developers
- Dynamic multi language support
Installation
1. Install Node.js/npm and Git
Windows:
- https://nodejs.org/en/download/
- https://git-scm.com/download/win (Choose: Use/run Git from the Command Prompt (cmd.exe))
Ubuntu/Debian:
$ sudo apt-get install -y nodejs
$ sudo apt-get install -y git-core
2. Install dependencies
From the project folder install all build script packages and all 3rd party dependencies
$ npm install --global bower
$ npm install --global gulp-cli
$ npm install
$ npm run dist
3. Import database (databse/database.sql)
Configurations
1. Basic config
Create the file secrets.php in the api/ folder.
<?php
$database = 'mysql';
$host = '127.0.0.1';
$dbname = 'rartracker';
$username = 'root';
$password = '';
Some site settings in api/Config.php and app/app.config.js should be changed!
2. Generate new unique salt hashes (optional for security)
- Note that updating the salts will make current registered accounts unusable, you'd want to log in and create invite codes (step 4) before changing salts and finally registering new accounts.
- $passwordSalt and $cookieSalt in User.php should be updated with new random hashes.
3. Create admin accounts
Use built in account named "System" password: "password" to create invites and register new admin-accounts The "System" account must remain as a parked account and have Staff rights because it's used as deleter of torrents, sender of PM and creation of forum topics etc. Change System password.
Server settings
Recommended packages
php5 apache2 mariadb-server libapache2-mod-php5 php5-mysql memcached php5-curl php5-memcached
Enable rewrite module and change AllowOverride from "None" to "All" in httpd.conf in order for .htaccess to work
a2enmod rewrite
Permissions
The following folders needs to be created and be given write permission:
- torrents/
- subs/
- img/imdb/
Recommended MariaDB settings
This is for making the fulltext search work
[mysqld]
ft_min_word_len=1
ft_stopword_file='stopword_file.txt'
tmp_table_size=2G
max_heap_table_size=2G
Nginx configuration
location / { try_files $uri /index.html;}
location ~ ./img { }
location ~ ./phpMyAdmin { }
location ~ .(html)$ { }
location /api { rewrite ^/api/v1/(.*)$ /api/api-v1.php?url=$1 break; }
General Configurations
You'll need to listen on:
Port 80 to reach the site Port 1337 so torrent clients can talk to the tracker Port 1338 ( with SSL enabled! ) so torrent clients can securely talk to the tracker By default this option is enabled for every member In /api/Config.php you'll need to edit TRACKER_URL and TRACKER_URL_SSL.
<?php
const TRACKER_URL = "http://<hostname>:1337";
const TRACKER_URL_SSL = "https://<hostname>:1338"
Obviously replace with whatever hostname you use.
Dev-hint
If you want to force regular HTTP tracker communication, just set TRACKER_URL_SSL to the same value as TRACKER_URL. This allows you to ignore messing with SSL for a while.
I do recommend setting up SSL if you're using this in production.
Crontab settings (crontab -e)
12 * * * * wget -O /dev/null http://127.0.0.1/api/v1/run-leechbonus
*/20 * * * * wget -O /dev/null http://127.0.0.1/api/v1/run-cleanup
0 0 * * * wget -O /dev/null http://127.0.0.1/api/v1/fetch-tvdata
0 0 * * 5 wget -O /dev/null http://127.0.0.1/api/v1/run-bonus
0 20 * * * wget -O /dev/null http://127.0.0.1/api/v1/run-statistics
Language support
The default language is English, but if you want the back and front end to default to another of the available languages you need to change the default language variable in Config.php and app.config.js. If the user changes the display language, the default language will still be used for site wide logs and automatic messages.
Developing and deploying
Developing
In the project folder run npm run watch
. This will lauch a watcher that continuously build the code into the dist/.
Deploying
In the project folder run npm run dist
and the code will be minified and scrambled, a JsHint check will also be made.
The following folders should not exist in production. The bundles contains everything needed. app/ bower_components/ node_modules/