README

Bull-powered BitTorrent tracker engine

🐂 About TorrentPier

TorrentPier — bull-powered BitTorrent 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 3.0 is a complete architectural overhaul of the engine, moving from legacy PHP to modern Laravel-inspired patterns.

Key modernizations in 3.0:

DI Container: Illuminate Container with 11 service providers
Bootstrap Pipeline: Modular initialization with bootstrappers
PSR-7/PSR-15: Modern HTTP stack with middleware architecture
Twig Templates: Replacing a legacy styles system
Bull CLI: Console commands for all operations
Unified Routing: Single entry point with semantic URLs

See the Upgrade Guide for migration details and the documentation for full reference.

✨ 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 detailed installation instructions, see our Installation Guide.

Quick start:

git clone https://github.com/torrentpier/torrentpier.git
cd torrentpier
composer install
php bull app:install

For Docker setup, see the Docker documentation.

Tip

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

After installation:

Log in using admin/admin credentials
Change your password immediately
Configure the site via admin panel

🔐 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.

📦 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.

torrentpier / torrentpier

Maintainers

Details