PteroCA

Professional Client Area & Billing Panel for Pterodactyl Hosting

Transform your Pterodactyl hosting into a complete SaaS business with automated billing, server provisioning, and a powerful plugin ecosystem.

What's New • Demo • Features • Quick Start • Documentation • Community

---

🚀 What's New in v0.6

Version 0.6 introduces a plugin-first architecture that fundamentally changes how PteroCA can be extended and customized.

Highlights

• 🔌 Complete Plugin System — first-class plugins with lifecycle management, security checks, and full framework access
• ⚡ Event-Driven Architecture — 245+ events covering forms, CRUD, emails, permissions, and widgets
• 🔐 Granular Permissions — 40+ fine-grained permissions with plugin-defined access control
• 🎨 Universal Widget System — context-aware UI extensions for dashboards, admin panels, and navigation
• 💳 Payment Provider Extensibility — built-in Stripe, PayPal via plugin, and custom providers
• 🎨 Modern UI Refresh — updated design, custom fonts, and full dark mode support

View Full Changelog | Documentation

---

📺 See It In Action

Complete workflow: User login → Server purchase → Real-time management (console, stats, controls)

Try the Live Demo

Experience PteroCA with full functionality:

• URL: https://demo.pteroca.com
• Login: demo@pteroca.com
• Password: PterocaDemo

Note: Editing features are restricted in the demo environment.

---

✨ Core Features

Advanced Billing System

• Flexible Pricing Models - Time-based (hourly, monthly, yearly), usage-based (per-slot), and multi-period pricing with different rates for different durations
• Automated Billing Cycles - Automatic server suspension for non-payment, renewal reminders, and grace periods
• Voucher System - Balance top-up and discount codes with email verification
• Payment Processing - Stripe (built-in), PayPal (plugin), and extensible payment provider system

Complete Server Management

• Automated Provisioning - Instant server creation via Pterodactyl API with customizable configurations and egg-based product templates
• Real-Time Control Panel - Live console access, server statistics (CPU, RAM, disk, network), and power controls
• Advanced Features - Database management, backup creation and restoration, port allocation, subuser management with permissions, schedule/task management, and startup variable configuration

Plugin Ecosystem

• Developer-Friendly - Full Symfony integration with PSR-4 autoloading, Doctrine ORM support, and EasyAdmin CRUD generation
• Security & Quality - Automated security scanning, plugin health monitoring, dependency management, and capability-based permissions
• Official Plugins - Hello World Plugin, PayPal Payment Provider, and more in development

Browse Plugin Documentation →

Internationalization

• 14 Languages - English, German, French, Spanish, Italian, Portuguese, Dutch, Polish, Russian, Ukrainian, Chinese, Hindi, Indonesian, Swiss German

Enterprise Security

• Permission-Based Access Control - 40+ granular permissions with role-based management and plugin-specific permissions
• Security Features - CSRF protection, XSS prevention, SQL injection safeguards, and trusted proxy support

Theming & Customization

• Built-in Theme System - Default responsive theme with dark/light mode support and custom CSS/JS injection
• Extensible Templates - Twig-based engine with view overrides and widget extension points

View All Features →

---

🚀 Quick Start

Installation Options

Choose the method that works best for you:

Automatic Installer (Recommended)

curl -sSL https://pteroca.com/installer.sh | bash

Perfect for production deployments. Handles all dependencies automatically.

Automatic Installation Guide →

Docker Compose (Fastest)

git clone https://github.com/PteroCA-Org/panel.git pteroca
cd pteroca
docker-compose up -d

Ideal for development and testing environments.

Docker Installation Guide →

Manual Installation

For custom environments or advanced configurations.

Manual Installation Guide →

Requirements

Component	Requirement
PHP	8.2+ with extensions: cli, ctype, iconv, mysql, pdo, mbstring, tokenizer, bcmath, xml, curl, zip, intl, fpm (NGINX)
Database	MySQL 5.7.22+ (MySQL 8 recommended) or MariaDB 10.2+
Web Server	NGINX or Apache
Pterodactyl	v1.11+ (compatible with latest versions)
Tools	Git, Composer 2, cURL, tar, unzip

Next Steps

After installation, configure your instance:

1. Run the setup wizard at https://your-domain.com/first-configuration or use php bin/console pteroca:system:configure
2. Configure Pterodactyl API connection
3. Set up your first payment provider
4. Create product categories and offerings

Complete Setup Guide →

---

🔌 Plugin System

Plugins are first-class citizens in PteroCA — not extensions bolted onto the core, but a foundational architecture designed for extensibility from day one.

Extend PteroCA with custom functionality through the comprehensive v0.6 plugin system.

Why Plugins?

• Zero Core Modifications - Extend functionality without touching core code
• Full Framework Access - Leverage Symfony, Doctrine, Twig, and EasyAdmin
• Event-Driven Hooks - 245+ events to tap into every system action
• Professional Tools - Security scanning, health monitoring, dependency management

Plugin Capabilities

Capability	Use Cases
Routes	Payment providers, custom pages, webhooks
Entities	Store plugin data, extend user profiles
Widgets	Dashboard widgets, admin panels, custom UI
Events	Webhook integrations, automation, custom logic
Console	Maintenance tasks, data migration, automation
Cron	Scheduled tasks, periodic cleanups, reports

Official Plugin Examples

• PayPal Payment Provider - Payment gateway integration
• Hello World - Comprehensive example demonstrating all capabilities (/plugins/hello-world)

Plugin Development Guide → | Plugin API Reference →

---

🤝 Community & Support

💬 Discord Get help, share ideas, and connect with the community

📚 Documentation Comprehensive guides, tutorials, and API references

🐛 Issues Report bugs and request features

🗺️ Roadmap See what's coming next

Ways to Support PteroCA

⭐ Star this Repository - The #1 way to support us! Stars help us reach more users and validate our work.

💖 Sponsor Development - Support ongoing development through:

• GitHub Sponsors
• Buy Me a Coffee
• Ko-fi

🎁 Sponsor Perks: Supporters get a special Discord role + access to a priority support channel.

Sponsors 💜

---

🗺️ Roadmap

PteroCA is actively developed with a clear roadmap and regular releases.

Vote on features and track progress:

• Official Roadmap Page

Have an idea? Submit a feature request →

---

🛠️ Contributing

We welcome contributions from developers of all skill levels!

Get Started

1. Join our Discord and request the Developer role for access to exclusive development channels
2. Review our guidelines - Contributing Guide and Code of Conduct
3. Pick an issue - Check Good First Issues

Contribution Areas

• Code - Features, bug fixes, refactoring
• Documentation - Guides, tutorials, API docs
• Translations - Add or improve language files
• Plugins - Build and share community plugins
• Testing - Write tests, report bugs
• Design - UI/UX improvements, themes

Read the Contributing Guide →

---

📄 License

PteroCA is open-source software licensed under the MIT License.

TL;DR: Free to use, modify, and distribute, even commercially. See LICENSE for full terms.

---

🙏 Acknowledgments

• Built on the excellent Pterodactyl Panel
• Powered by Symfony Framework
• Admin interface by EasyAdmin Bundle

---

Made with ❤️ by the PteroCA team and contributors

Website • Documentation • Discord • GitHub

⭐ If you find PteroCA useful, please consider giving us a star! ⭐