Support
Getting started
How do I connect my panel?
Open the app, add a panel, and enter your panel's address (use https://) and a Client API key. To create one, sign in to your panel, go to Account, API Credentials, create a key and copy it straight away, because the panel shows it only once.
What do I need for the admin features?
Admin screens (nodes, users, servers, locations, database hosts, eggs and so on) need an admin-level key. On Pterodactyl 1.x that is an Application API key from Admin, Application API, which you can add to the panel in the app. On Pterodactyl 2.0, a root administrator's Client API key also works. Your panel account must be allowed to do those things.
Which panels are supported?
PteroControl is built for Pterodactyl 1.x and also works with 2.0 panels, including their tags and extensions. Some features depend on your panel's version and settings, and a feature your panel does not offer will show an error instead of working.
What is the demo panel?
It is made-up sample data so you can look around without a panel of your own. Nothing in it is a real server.
Troubleshooting
I cannot connect to my panel
- Check the address starts with
https://and opens in your phone's browser. - Make sure the key is a Client API key from the same panel, copied in full.
- If your panel is behind a firewall, VPN or a service like Cloudflare Access or bot protection, it may block the app. Allow API requests to
/api/client. - If your key is restricted to certain IP addresses, your phone's address must be on that list.
The console will not connect
The live console talks to your server's Wings node, not just the panel. The node's address and port must be reachable from your phone, with a working HTTPS certificate. If statistics still update but the console is silent, the node's websocket is usually blocked.
I see "too many requests" or the panel is limiting requests
Pterodactyl allows roughly 240 API requests a minute per key. The app keeps itself under that limit and waits when the panel asks it to slow down. If you see this message, wait a few seconds. If other tools use the same key, give each tool its own key.
The theme does not follow my iPhone's light or dark setting
Set the theme to System in Settings. This needs the latest version of the app from the App Store.
Push alerts
How do push alerts work?
iOS stops apps in the background, so a small service we run checks your panel and asks Apple to notify you when a running server goes offline or uses nearly all of its memory. When you switch alerts on, the app makes a new API key called "PteroControl push relay" on your panel and sends only that key, the panel's name and address, and your device's push token to the service. Your own key and password are never sent. Details are in the privacy policy.
How do I turn alerts off or delete my data?
Switch them off in the app's Settings. That removes your panel address and key from the service. You can also delete the "PteroControl push relay" key in your panel under Account, API Credentials, which stops alerts at once. To ask us to delete anything else, email [email protected].
Switching alerts on fails
- Allow notifications for PteroControl in iOS Settings.
- Push needs a real iPhone or iPad, not a simulator.
- If the message mentions a firewall or bot protection, your panel is blocking the alert service. Allow its requests to
/api/client. - Your account may already have the maximum number of API keys. Delete one you no longer use and try again.
Your data
Where are my keys stored?
In the iOS Keychain on your device. The app does not send them to us, except for the separate key created for push alerts if you turn them on. See the privacy policy.
Does the app collect analytics?
No. There are no accounts, ads, analytics or tracking.
Report a problem or share an idea
Email [email protected]. If you have found a security issue, please email us privately first and give us a chance to fix it before sharing it publicly.