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 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 of it.

✨ 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 is 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 / MariaDB 10.0 or above / Percona
PHP: 8.1 / 8.2 / 8.3 / 8.4
PHP Extensions: 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.

Important

Thanks to Sergei Solovev for this installation script ❤️

Quick (For web-panels) ☕️

Select the folder where you want TorrentPier installed
```
cd /path/to/public_html
```

Download the latest version of TorrentPier

sudo git clone https://github.com/torrentpier/torrentpier.git .

After completing, execute the command below and follow the instructions
```
php install.php
```
Voila! ✨

Manual 🔩

Install Composer
Run the following command to create the TorrentPier project
```
composer create-project torrentpier/torrentpier
```
Check our system requirements
After, run this command in the project directory to install Composer dependencies
```
composer install
```
Create a database and import the dump located at install/sql/mysql.sql
Edit database configuration settings in the environment (.env.example), after, rename to .env
Provide write permissions to the specified folders:
- data/avatars, data/uploads, data/uploads/thumbs
- internal_data/atom, internal_data/cache, internal_data/log, internal_data/triggers
- sitemap
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 👣

Edit these files:
- favicon.png (change to your own)
- robots.txt (change the addresses in lines Host and Sitemap to your own)
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.

📌 Our recommendations

It's recommended to run cron.php. - For significant tracker speed increase it ay be required to replace the built-in cron.php in operating system daemon.
Local configuration copy. - You can override the settings using the local configuration file library/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 renew 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.

torrentpier / torrentpier

Maintainers

Details