Gazelle

Gazelle is a web framework geared towards private BitTorrent trackers. Although naturally focusing on music, it can be modified for most needs. Gazelle is written in PHP, Twig, JavaScript, and MySQL.

Gazelle Runtime Dependencies

• Nginx (recommended)
• PHP 7.4.27+ (required)
• NodeJS 12+ (required)
• Memcached (required)
• Sphinx 2.0.6 or newer (required)
• procps-ng (recommended)

Gazelle/Ocelot Compile-time Dependencies

• Git (required)
• ocelot
• GCC/G++ (4.7+ required; 4.8.1+ recommended)
• Boost (1.55.0+ required)

Gazelle/Ocelot Compile-time Dependencies

• Git (required)
• GCC/G++ (4.7+ required; 4.8.1+ recommended)
• Boost (1.55.0+ required)

Note: This list may not be exhaustive.

Logchecker

To fully utilize the Logchecker, you must install the following depedencies through pip:

• chardet
• eac-logchecker
• xld-logchecker

Installation

We provide installation notes here. These notes are provided as a best effort, and are not guaranteed to be fully up-to-date or accurate.

Due to the nature of torrenting, we HIGHLY recommend not trying to run this in production if you are not prepared or knowledgeable in setting up servers, proxies, and tuning TCP configs to get proper performance and privacy.

Development

Docker is used to develop Gazelle. See https://docs.docker.com/engine/install/ for more information on getting Docker set up locally.

Ocelot

The ocelot repository is used to build build the Ocelot image. To keep things simple, check out the source in a sibling directory to Gazelle.

git clone https://github.com/OPSnet/ocelot
docker build . -t ocelot

Gazelle

In the root folder of the Gazelle repository, run the following command:

docker-compose up

This will pull and build the needed images to run Gazelle on Debian Bullseye. A volume is mounted from the base of the git repository at /var/www in the container. Changes to the source code are immediately served without rebuilding or restarting.

You can access the site by viewing http://localhost:8080

The first account is 'admin' and has the highest level of access to the site installation. The second account is 'user' and has standard user access. The passwords for both accounts are literally 'password' (without the quotes). If you want to change these before building, edit db/seeds/InitialUserSeeder.php first.

The 'admin' account might not have all the permissions that have been added recently. Navigate to the /tools.php?action=permissions page and tick everything.

Ports

The following ports are forwarded:

• 80 -> 8080 (web)
• 3306 -> 36000 (mysql)
• 34000 -> 34000 (ocelot)

Going further

You may want to install additional packages:

• apt update
• apt install less procps vim

If you want to poke around inside the web container, open a shell:

export WEBCONT=$(docker ps|awk '$2 ~ /web$/ {print $1}')

docker exec -it $WEBCONT bash

To keep an eye on PHP errors during development:

docker exec -it $WEBCONT tail -n 20 -f /var/log/nginx/error.log

To create a Phinx migration:

docker exec -it $WEBCONT vendor/bin/phinx create MyNewMigration

Edit the resulting file and then apply it:

docker exec -it $WEBCONT vendor/bin/phinx migrate

To access the database, save the following in ~root/.my.cnf of the database container:

    [mysql]
    user = root
    password = password
    database = gazelle

And then:

docker exec -it $(docker ps|awk '$2 ~ /^mariadb/ {print $1}') mysql

In the same vein, you can use mysqldump to perform a backup.

Boris

You can run Boris directly:

docker exec -it $WEBCONT /var/www/boris

Production Mode (not yet fully baked)

In order to have Docker run the container using the production mode commands for both Composer and NPM, run this when powering it up:

ENV=prod docker-compose up

Contact and Discussion

Feel free to join #develop on irc.orpheus.network to discuss any questions concerning Gazelle (or any of the repos published by Orpheus).

Open source

Create issues at https://github.com/OPSnet Patches welcome!