Before you begin
Make sure you:- Have access to a Pterodactyl or Pelican panel that you are authorized to manage.
- Can create a Client API key in that panel.
- Have the PteroControl Discord application available in a server where you can use its commands.
Add your panel
1
Review API key guidance
Run
/guide apikey in Discord. Follow the guidance for creating a Client API key in your panel.2
Create a dedicated API key
Create a key for PteroControl and grant only the permissions you need. Keep the key private.
3
Start the panel form
Run
/panel add and provide a panel name, the panel URL, and your Client API key. If your panel requires a separate Application API key for administrator operations, provide that credential when prompted.4
Accept the legal policies if prompted
When adding your first panel, review and accept the Terms of Service and Privacy Policy. After accepting, run
/panel add again to open the panel form.5
Choose a server
Run
/client servers manage and select the server you want to manage./client server to access the selected server’s available management actions.
Manage saved panels
PteroControl supports multiple saved panel connections for your Discord account.
After switching panels, choose the server you want to work with using
/client servers manage.
Panel compatibility and permissions
PteroControl detects whether a connected panel is Pterodactyl or Pelican. Available operations can differ by panel flavor, version, and API capability. A command or action may be hidden or unavailable when the panel does not support the required operation or your API key does not have permission. For Pterodactyl 2.0 Application/Admin API operations, follow/guide apikey and the credential guidance shown by the relevant command. Do not assume that every operation is available on every panel version.
Keep your credentials safe
- Do not share your API key or paste it into public channels.
- Use a dedicated key with least-privilege permissions.
- Saved API keys are encrypted at rest by PteroControl.
- If a key is exposed or no longer needed, revoke it in your panel. Removing a panel from PteroControl does not revoke the key inside the panel.
