Need help with Gazelle?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

220 Stars 80 Forks The Unlicense 1.4K Commits 45 Opened issues

Services available


Need anything else?

Contributors list


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, JavaScript, and MySQL.

Gazelle Runtime Dependencies

Note: This list may not be exhaustive.


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

: * chardet * eac-logchecker * xld-logchecker


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.

Gazelle Development

Docker is used to develop Gazelle. See for more information on getting Docker set up locally.

Setup the ocelot container image, by doing the following:

git clone
docker build . -t ocelot

Within the gazelle folder, run the following command:

docker-compose up

This will build and pull the needed images to run Gazelle on Debian Buster. A volume is mounted from the base of the git repository at

in the container. Changes to the source code are immediately served without rebuilding or restarting.


The following ports are forwarded: * 80 -> 8080 (web) * 3306 -> 36000 (mysql) * 34000 -> 34000 (ocelot)

You can access the site by going to


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

of the database container:
    user = root
    password = 
    database = gazelle

And then:

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

In the same vein, you can use

to perform a backup.


You can run Boris directly:

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

Production Mode (not fully baked yet)

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 to discuss any questions concerning Gazelle (or any of the repos published by Orpheus).

Open source

Open issues at Patches welcome!

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.