codebattles

Competition Management: Create and manage programming contests with ease
Real-time Judging: Automated code evaluation and scoring
Multi-language Support: Support for various programming languages
User Management: Role-based access control for participants and administrators
Live Leaderboards: Real-time ranking and progress tracking
Task Generation: Built-in UI for creating competition tasks (v3.x.x+)

🚀 Quick Start

Prerequisites

Docker
Docker Compose

Installation

Clone the repository
Start the application
💡 Tip: Run in background mode with the
-d
flag:
Access the application

Open your browser and navigate to http://localhost:2500

🔄 Updating

To update to the latest version:

⚙️ Configuration

Default Ports

Service	Port	Description
Gateway	2500	Main application interface
Database	25565	Database connection

Task Management

Starting from version 3.x.x, competition tasks can be created and managed through the web interface, making it easier for administrators to set up contests without technical knowledge.

🖥️ Platform Compatibility

Architecture	Status	Notes
x64	✅	Requires manual build
aarch64	✅	Requires manual build
x32	❓	Not tested

🤝 Contributors

We're grateful to these amazing contributors who have helped make CodeBattles better:

Core Contributors

Doctorixx - Project maintainer and lead developer
user3050 - Security audit and vulnerability assessment
Zeevss - Testing, quality assurance, and feature suggestions

Special Thanks

school30nn - For adopting the system and providing valuable server resources

🛠️ Development

Security Analysis

This project uses PVS-Studio for static code analysis, ensuring high code quality and security standards.

💖 Support the Project

If you find CodeBattles useful and want to support its development:

☕ DonationAlerts
💳 YooMoney

📄 License

This project is licensed under the terms specified in the LICENSE file.

🐛 Issues & Support

Found a bug or need help? Please check our documentation first, then feel free to:

🐛 Report issues
💬 Join discussions
📧 Contact the maintainers