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:

1. Log in using admin/admin credentials
2. Change your password immediately
3. 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.