# rartracker

**Repository Path**: 511311/rartracker

## Basic Information

- **Project Name**: rartracker
- **Description**: A modern front and backend bittorrent tracker written in AngularJS and PHP.
- **Primary Language**: PHP
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2017-10-02
- **Last Updated**: 2025-09-03

## Categories & Tags

**Categories**: networklib

**Tags**: None

## README

# 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:**
```sh
$ 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
```sh
$ 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
```sh
[mysqld]
ft_min_word_len=1
ft_stopword_file='stopword_file.txt'
tmp_table_size=2G
max_heap_table_size=2G
```

## Nginx configuration
```sh
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
<?php
    const TRACKER_URL = "http://<hostname>:1337";
    const TRACKER_URL_SSL = "https://<hostname>:1338"
```

Obviously replace <hostname> 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)
```sh
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/

# License
[WTFPL]

[//]: #
[WTFPL]: <http://www.wtfpl.net/>