torrentpier/torrentpier

TorrentPier. Bull-powered BitTorrent tracker engine

v2.8.9 2025-11-28 14:05 UTC

Requires

• php: >=8.2
• arokettu/bencode: ^4.1.0
• arokettu/monsterid: ^4.1.0
• arokettu/random-polyfill: 1.0.2
• arokettu/torrent-file: ^5.2.1
• bugsnag/bugsnag: ^v3.29.1
• egulias/email-validator: ^4.0.1
• filp/whoops: ^2.15
• gemorroj/m3u-parser: ^6.0
• google/recaptcha: ^1.3
• gregwar/captcha: 1.*
• guzzlehttp/guzzle: ^7.10
• intervention/image: ^3.0
• jacklul/monolog-telegram: ^3.1
• league/flysystem: ^3.28
• longman/ip-tools: 1.2.1
• monolog/monolog: ^3.4
• nesbot/carbon: ^3.10
• nette/caching: ^3.3
• nette/database: ^3.2
• php-feed-io/feed-io: ^6.1
• php-http/guzzle7-adapter: ^1.1
• robmorgan/phinx: ^0.16.9
• samdark/sitemap: 2.4.1
• symfony/config: ^7.3
• symfony/event-dispatcher: ^7.3
• symfony/filesystem: ^7.3
• symfony/mailer: ^7.3
• symfony/mime: ^7.3
• symfony/polyfill: v1.33.0
• symfony/string: ^7.3
• torrentpier/translations: dev-main
• twig/twig: ^3.21
• vlucas/phpdotenv: ^5.5
• z4kn4fein/php-semver: ^v3.0.0

Requires (Dev)

• mockery/mockery: ^1.6
• pestphp/pest: ^3.8
• symfony/var-dumper: ^7.3

MIT

• Exile
• Diolektor
• PheRum
• belomaxorka
• kovalensky

• forum
• bittorrent
• torrent
• tracker

README

Bull-powered BitTorrent tracker engine

🐂 About TorrentPier

TorrentPier — bull-powered BitTorrent Public/Private tracker engine, written in PHP. High speed, simple modifications, load-balanced architecture. In addition, we have a very helpful official support forum, where it's possible to get support and download modifications for the engine.

🌈 Current status

TorrentPier is currently in active development. The goal is to remove all legacy code and rewrite the existing code to modern specifications. If you want to delve deep into the code, check our issues and go from there. The documentation will be translated to English in the near future, currently Russian is the main language.

✨ Features

• Rich forum with browsing/moderation tools
• High-load capable, heavily configurable announcer
• Scrape support
• FreeLeech
• TorrServer integration support
• BitTorrent v2 support
• Event-based invite system
• Bonus points
• Polling system
• PM/DM system
• Multilingual support (Russian and English are currently fully supported, with others in the future)
• Atom/RSS feeds
• ... and so MUCH MORE!

🖥️ Demo

• URL: https://torrentpier.duckdns.org
• Username: admin
• Password: admin

Note

Demo resets every 24 hours!

🔧 Requirements

• Apache / nginx (example config) / caddy (example config)
• MySQL 5.5.3 or above (including MySQL 8.0+) / MariaDB 10.0 or above / Percona
• PHP: 8.4 / 8.5
• PHP Extensions: mysqli, mbstring, gd, bcmath, intl, tidy (optional), xml, xmlwriter
• Crontab (Recommended)

💾 Installation

For the installation, select one of the installation variants below:

Quick (Clean install) 🚀

Check out our autoinstall repository with detailed instructions.

Note

Thanks to Sergei Solovev for this installation script ❤️

Quick (With installation script) ☕️

1. Select the folder where you want TorrentPier installed

   cd /path/to/www

2. Download the latest version of TorrentPier

   git clone --branch master --depth 1 https://github.com/torrentpier/torrentpier.git .

3. Install dependencies and run the installation wizard

   composer install
   php bull app:install

4. Voila! ✨

Manual 🔩

1. Check our system requirements
2. Select the folder where you want TorrentPier installed

   cd /path/to/www

3. Download the latest version of TorrentPier

   git clone --branch master --depth 1 https://github.com/torrentpier/torrentpier.git .

4. Install Composer dependencies

   composer install --no-dev --prefer-dist --optimize-autoloader

5. Run the installation wizard (configures .env, creates database, runs migrations)

   php bull app:install

6. Voila! ✨

Tip

The php bull app:install wizard handles all configuration: environment setup, database creation, migrations, and permissions.

Using Docker 🐳

1. Ensure Docker and Docker Compose are installed on your system. Verify that ports 80 (HTTP) and 443 (HTTPS) are free or adjust them in the docker-compose.yml
2. Select the folder where you want TorrentPier installed

   cd /path/to/www

3. Download the latest version of TorrentPier

   git clone --branch master --depth 1 https://github.com/torrentpier/torrentpier.git .

4. Copy the Docker environment template (.env.docker) file and configure it

   cp .env.docker .env

5. Configure environment variables in .env. Edit the file and adjust values according to your environment

   nano .env  # or use your preferred editor

6. Start the application with Docker Compose

   docker compose up -d

7. Voila! ✨

Important

The specific settings depend on the server you are using, but in general we recommend chmod 0755 for folders, and chmod 0644 for the files in them.

Additional steps 👣

1. Edit these files:
   • favicon.png (change to your own)
   • robots.txt (change the addresses in lines Host and Sitemap to your own)
2. Log in to the forum using the admin/admin login/password, and finish setting up via admin panel. Don't forget to change your password!

🔐 Security vulnerabilities

If you discover a security vulnerability within TorrentPier, please follow our security policy, so we can address it promptly.

🧪 Testing

TorrentPier includes a comprehensive testing suite built with Pest PHP. Run tests to ensure code quality and system reliability:

# Run all tests
./vendor/bin/pest

# Run with coverage
./vendor/bin/pest --coverage

For detailed testing documentation, see tests/README.md.

📌 Our recommendations

• Set up cron jobs. - Run php bull cron:run every minute for maintenance tasks. For high-traffic trackers, consider running it more frequently or as a daemon.
• Local configuration copy. - You can override the settings using the local configuration file config/config.local.php.

💚 Contributing / Contributors

Please read our contributing policy and code of conduct for details, and the process for submitting pull requests to us. But we are always ready to review your pull-request for compliance with these requirements. Just send it!

Made with contrib.rocks.

💞 Sponsoring

Support this project by becoming a sponsor or a backer.

Monero

42zJE3FDvN8foP9QYgDrBjgtd7h2FipGCGmAcmG5VFQuRkJBGMbCvoLSmivepmAMEgik2E8MPWUzKaoYsGCtmhvL7ZN73jh

YooMoney

4100118022415720

📦 Versioning

We use SemVer for versioning. For the versions available, see the tags on this repository.

📖 License

This project is licensed under the MIT License - see the LICENSE file for details.