Page cover

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.

Plugin System Introduced

PteroCA v0.6+ includes a comprehensive plugin architecture that allows you to extend functionality without modifying core code. Create custom payment providers, integrations, dashboard widgets, server management features, and more.

Example plugins included: hello-world (demonstrates all capabilities) and paypal-payment (PayPal integration).

Learn more about the plugin system →

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

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.

Try the Demo

Note: Certain administrative features and configurations are restricted in the demo environment. For full functionality, install your own instance.


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.

Support the Project

If you find PteroCA useful, please consider starring our GitHub repository. It helps us grow and shows your support!


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:

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:


Ready to get started? Begin with the Quick Start Guide to reach your first server sale in under an hour.

Last updated