PteroCA Pterodactyl Addon
PteroCA Pterodactyl Addon is a plugin designed to integrate Pterodactyl with the PteroCA panel.
1. Overview
The PteroCA Pterodactyl Addon is the official plugin for the PteroCA project, providing direct and seamless integration between the Pterodactyl game server management panel and the PteroCA client & billing panel.
This addon is required for PteroCA to function properly. Without it, the panel will not be able to communicate with your Pterodactyl installation, and core features such as server synchronization, Single Sign-On (SSO), and automated resource management will not work.
2. Key Features
Installing the addon unlocks full integration between PteroCA and Pterodactyl, including:
Full Server Management from PteroCA Access server consoles, start/stop/restart servers, monitor live CPU, RAM, and disk usage, and manage startup variables without leaving PteroCA.
Automatic Account & Server Synchronization When a user or server is created in PteroCA, it is automatically created and linked in Pterodactyl — and vice versa.
Single Sign-On (SSO) Users can open their Pterodactyl panel directly from PteroCA without re-entering credentials (if SSO is enabled in settings).
Extended API Capabilities Adds API endpoints that PteroCA needs for package assignments, resource updates, server variable management, and automated deployments.
Unified User Experience Eliminates the need for users to manually switch between separate panels to manage their services.
3. Requirements
Before installing the addon, make sure your environment meets the following requirements:
Pterodactyl Panel: v1.11.0 or later
PteroCA Panel: Matching the addon version
Server Requirements:
PHP 8.1+
Composer installed
Access: File system access to your Pterodactyl panel installation and ability to run
artisan
commands
4. Installation
Navigate to Pterodactyl’s root directory
cd /var/www/pterodactyl
Install the addon via Composer
composer require pteroca-com/pterodactyl-addon
This plugin is essential as it enables the creation of Client API Keys through the API interface — something not possible in a standard Pterodactyl installation. These keys are required for proper server management in PteroCA.
Clear and rebuild cache
php artisan optimize:clear
(Optional but recommended after installation or update)
5. Updating the Addon
Navigate to your Pterodactyl root directory:
cd /var/www/pterodactyl
Update the package:
composer update pteroca-com/pterodactyl-addon
Clear cache:
php artisan optimize:clear
6. Troubleshooting
Cannot log in to PteroCA
Addon not installed
Install the addon and recreate the user using the create:new-user CLI command
SSO not working
SSO not enabled in PteroCA
Enable it in Settings → Pterodactyl Integration in PteroCA, and make sure the API token is configured in your Pterodactyl .env
file.
Servers not visible in PteroCA
Wrong API URL or key
Double-check settings in PteroCA
Addon errors after update
Version mismatch
Verify installed version
7. Source Code
The addon is fully open-source and available at: https://github.com/pteroca-com/pterodactyl-addon
8. Need help?
If you experience any issues or need assistance with installation, join our Discord community — we’re happy to help: Join to Discord!
Last updated