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
Version 0.6 introduces a plugin-first architecture that fundamentally changes how PteroCA can be extended and customized.
- 🔌 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
Complete workflow: User login → Server purchase → Real-time management (console, stats, controls)
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.
- 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
- 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
- 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
- 14 Languages - English, German, French, Spanish, Italian, Portuguese, Dutch, Polish, Russian, Ukrainian, Chinese, Hindi, Indonesian, Swiss German
- 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
- 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
Choose the method that works best for you:
curl -sSL https://pteroca.com/installer.sh | bashPerfect for production deployments. Handles all dependencies automatically.
Automatic Installation Guide →
git clone https://github.com/PteroCA-Org/panel.git pteroca
cd pteroca
docker-compose up -dIdeal for development and testing environments.
For custom environments or advanced configurations.
| 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 |
After installation, configure your instance:
- Run the setup wizard at
https://your-domain.com/first-configurationor usephp bin/console pteroca:system:configure - Configure Pterodactyl API connection
- Set up your first payment provider
- Create product categories and offerings
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.
- 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
| 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 |
- PayPal Payment Provider - Payment gateway integration
- Hello World - Comprehensive example demonstrating all capabilities (
/plugins/hello-world)
Plugin Development Guide → | Plugin API Reference →
Get help, share ideas, and connect with the community |
Comprehensive guides, tutorials, and API references |
Report bugs and request features |
See what's coming next |
⭐ 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:
🎁 Sponsor Perks: Supporters get a special Discord role + access to a priority support channel.
PteroCA is actively developed with a clear roadmap and regular releases.
Vote on features and track progress:
Have an idea? Submit a feature request →
We welcome contributions from developers of all skill levels!
- Join our Discord and request the Developer role for access to exclusive development channels
- Review our guidelines - Contributing Guide and Code of Conduct
- Pick an issue - Check Good First Issues
- 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
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.
- 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! ⭐