README

Bull-powered BitTorrent tracker engine

TorrentPier 3.0 (Ox) is the final release of this codebase. The project closed in May 2026 — read the closure announcement at https://sunset.torrentpier.com/. No further patches, security fixes, or feature work are planned. The community forum is preserved read-only at https://ox.torrentpier.com/. A new generation of the engine — codename Dexter — is being written from scratch, expected in 2027. If you self-host this release, you are responsible for your own security maintenance.

🐂 About TorrentPier

TorrentPier — bull-powered BitTorrent tracker engine, written in PHP. High speed, simple modifications, load-balanced architecture. The original community forum is preserved read-only at ox.torrentpier.com as a historical archive.

🌈 Current status

TorrentPier 3.0 (Ox) is the final release of this codebase. The project closed in May 2026: no further patches, security fixes, or feature work are planned. GitHub Issues remain open as a low-noise channel for community discussion, but there is no commitment to respond.

A new generation of the engine — codename Dexter — is being written from scratch, expected in 2027.

✨ 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!

🔧 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

Quick start:

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

For Docker setup, see docker-compose.yml and Dockerfile in this repository.

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

This release is closed and will not receive security patches. If you self-host TorrentPier 3.0 (Ox), you are responsible for your own security maintenance. See SECURITY.md for details.

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