Introduction
PteroCA is a modern, open-source client area and billing panel designed for hosting providers using Pterodactyl. It provides complete customer management, automated server provisioning, flexible billing models, and real-time server controls — all through a fast, multilingual, and highly customizable interface.
Built on Symfony 7, PteroCA serves as the frontend system for your hosting business, handling everything from user registration and payments to automated server lifecycle management. With v0.6, PteroCA introduces a comprehensive plugin system that enables extensibility without modifying core code.
Key Capabilities
Flexible Billing System — Support time-based, usage-based, or per-slot pricing models with customizable durations and dynamic costs.
Automated Server Provisioning — Automatically create, suspend, and delete servers in Pterodactyl based on payment status and billing cycles.
Real-Time Server Management — Full server control including console access, statistics monitoring, database management, backups, and port allocation.
Payment Processing — Built-in Stripe integration with extensible payment provider support through plugins.
Extensibility & Customization — Complete theme system and plugin architecture for unlimited customization without touching core code.
Multilingual Support — Interface available in multiple languages, ready for international hosting businesses.
What's New in v0.6
Version 0.6 represents a major milestone in PteroCA's development, introducing production-grade extensibility and enhanced access control.
Key improvements:
Plugin Architecture — Add payment providers, custom features, integrations, CRUD interfaces, console commands, and cron tasks through plugins.
Enhanced Permissions — Granular role-based access control with customizable permission sets for admin and user roles.
Security & Health Monitoring — Automatic security scanning, dependency validation, and health checks for all plugins.
Developer Experience — Complete CLI tools, comprehensive documentation, and real-world examples for plugin and theme development.
A full marketplace for community and premium plugins is planned for a future release.
Quick Start
Get Started in 30-60 Minutes
New to PteroCA? The Quick Start guide walks you through installation, configuration, and your first test sale in under an hour.
You'll accomplish:
Install PteroCA (5-10 minutes)
Complete minimal configuration (10-15 minutes)
Create your first product (10-15 minutes)
Process a test purchase (5-10 minutes)
The Quick Start path is designed to get you operational quickly, covering only the essential steps needed to reach your first server sale. Detailed configuration and advanced topics can be explored afterward.
Installation Options
If you prefer to start with installation details, PteroCA supports multiple installation methods:
Automatic Installation — Recommended for most users. Single-command installer that handles all dependencies, configuration, and setup automatically.
Docker Installation — Containerized setup ideal for both production and development environments. Includes automatic and manual options.
Manual Installation — Complete control over server configuration, dependencies, and PHP setup. Supports advanced scenarios including Windows environments.
See the full Installation Documentation for detailed instructions and requirements.
Demo
Explore PteroCA before installing with our live demo environment.
Getting Help & Community
Have questions or need assistance? The PteroCA community and development team are here to help.
Discord Community — Join our support server for real-time help, updates, announcements, and feedback discussions.
GitHub Repository — Open issues for bug reports and feature requests. Our team actively monitors and responds to GitHub activity.
Documentation Map
Navigate to the section that matches your current needs:
For New Administrators
Getting started with PteroCA for the first time:
Quick Start — Installation to first sale in 30-60 minutes
Installation — Detailed installation instructions and options
Core Configuration — Essential system settings: general, security, email, payments, Pterodactyl integration
For Business Management
Managing your hosting business and products:
Business Configuration — Products, categories, pricing models, vouchers, and promotions
Admin Panel — Managing users, servers, products, payments, and monitoring
Using PteroCA — Client area features and functionality
For Developers & Customization
Extending and customizing PteroCA:
Plugins — Installing and managing plugins to extend functionality
Plugin Development — Building custom plugins, payment providers, and integrations
Themes — Creating and managing custom themes
Theme Development — Building custom themes and UI components
CLI Reference — Command-line tools for management and automation
For Advanced Configuration
Scaling, security, and advanced topics:
Access & Permissions — Role-based access control and permission management
Advanced Topics — Scaling infrastructure, SSL configuration, trusted proxies, CSRF protection
Help & Maintenance — Updating, troubleshooting, FAQ, and common issues
Ready to get started? Begin with the Quick Start Guide to reach your first server sale in under an hour.
Last updated
