15. Troubleshooting & FAQ
|
Issue |
Cause |
Resolution |
|---|---|---|
|
“License Check Failed” panel on the Module Settings tab |
The WHMPress license key is missing or did not validate. |
Confirm the key in modules/servers/linode/license.php and that the server can reach whmcs.whmpress.com over HTTPS. Use the sync icon in the admin warning banner to re-check. |
|
Plan, Region and Image dropdowns are empty |
No Linode server is assigned to the product, or the access token is invalid. |
Assign the server on the Module Settings tab and save; then check the red API notice at the top of the dashboard for the exact Linode error. |
|
Test Connection fails |
Incorrect or expired Personal Access Token. |
Generate a new token in the Linode Cloud Manager with the scopes in Section 14.1 and re-enter it in the server’s Access Hash field. |
|
Provisioning fails with “No Linode plan (type) is configured” |
The product has no plan, region or image saved. |
Complete Section 6.1 and save the product. |
|
Provisioning fails with a creation-method message |
The Creation Method is set to something other than Public Image. |
Set Creation Method to Public Image; it is the supported method in this release. |
|
Client Area shows “This service has not been provisioned yet” |
The LinodeId custom field is empty for that service. |
Run the Create module command, or enter the correct Linode instance ID in the LinodeId custom field to re-link an existing instance. |
|
Client Area shows “The Linode instance could not be reached” |
The instance was deleted at Linode, or the token lost access to it. |
Verify the instance still exists in the Linode Cloud Manager and that the token has the Linodes scope. |
|
Password reset appears to do nothing |
The instance did not finish shutting down within the wait window. |
Retry in a moment. The module reports this explicitly rather than reporting a false success. |
|
A Client Area page returns a permission error |
The API token lacks the scope for that resource. |
Add the missing scope (Section 14.1) or create a new token, then update the server record. |
|
Graphs page shows a notice instead of charts |
The instance has not been running long enough for Linode to report statistics, or the Chart.js CDN is unreachable. |
Wait a few minutes after boot and reload. If the network blocks public CDNs, the notice is expected. |
|
A feature page is missing from the Client Area |
The page is disabled for that product. |
Enable it under Optional Client Area Pages (Section 6.5). |
|
Module colours do not match the template |
A custom template with no shipped colour mapping. |
Map the template’s variables on the Customization tab, or set the fallback palette on the Default tab (Section 6.3). |