Pterodactyl Integration
Integrate PteroCA with your Pterodactyl Panel to enable automatic server provisioning.
Required for Server Provisioning
Pterodactyl integration is required to provision servers. Without this integration, PteroCA can only operate as a storefront - customers can browse products but servers won't be created.
Overview
This integration connects PteroCA to Pterodactyl Panel, allowing:
Automatic server creation when customers purchase products
Server management through PteroCA client area
SSO (Single Sign-On) to Pterodactyl Panel
Server status and resource monitoring
Automatic server suspension and deletion
Integration Steps
Follow these guides in order to complete the integration:
Install the PteroCA addon on your Pterodactyl Panel. This addon enables PteroCA-specific features and API endpoints.
Required: Yes - must be installed before other steps
Create an API key in Pterodactyl Panel with the required permissions and configure it in PteroCA.
Required: Yes - needed for server provisioning
Configure CORS (Cross-Origin Resource Sharing) settings to allow PteroCA to communicate with Pterodactyl.
Required: Yes - prevents API connection errors
4. SSO Setup
Enable Single Sign-On to allow users to access Pterodactyl Panel directly from PteroCA without separate login.
Required: No - optional convenience feature
Quick Setup
For the fastest integration:
Install the Pterodactyl addon
Create API key with all read & write permissions
Run PteroCA configuration wizard:
Enter Pterodactyl URL and API key when prompted
Verification
Test that integration works:
Create a test product in PteroCA
Purchase the product as a test user
Verify server appears in Pterodactyl Panel
Check server has correct resources
Troubleshooting
Common issues:
API connection refused: Check allowed origins configuration
Servers not creating: Verify API key has correct permissions
SSO not working: Check SSO secret matches on both sides
For detailed troubleshooting, see individual integration pages.
Related Documentation
Pterodactyl Settings - Admin panel settings for Pterodactyl
Quick Start - Fast setup guide
Core Configuration - Other system settings
Last updated