CodeBattles 🏆

A comprehensive programming competition system designed for educational institutions, coding competitions, and skill assessment.

🔗 Quick Links

• 📚 Documentation (RU v3)
• 📚 Documentation (EN v3)
• 🌐 Official Website
• ☕ Support the Project

✨ Features

• 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

1. Clone the repository

   git clone https://github.com/CodeBattles-nn/CodeBattles.git
   cd CodeBattles

2. Start the application

   docker compose up

   💡 Tip: Run in background mode with the -d flag:

   docker compose up -d

3. Access the application

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

🔄 Updating

To update to the latest version:

# Pull the latest changes
git pull

# Restart the application
docker compose up

⚙️ 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

---

CodeBattles © 2024-2025 | Built with ❤️ for the programming community