Admin manual — Troubleshooting

Step-by-step guides for the Webfox client area and admin panel. CMS help articles remain at Knowledge Base.

Troubleshooting

Connection test fails

  • Hostname must be a URL (https://host:port)
  • cPanel: WHM token in api_token, user root or a reseller with API access
  • Plesk: admin user/password; REST /api/v2 and XML agent both used
  • DirectAdmin: use an admin account; package APIs are empty for user-level logins
  • CWP: api_token required; hostname port 2304; key format JSON; allow the Webfox server IP or ALL in CWP API Manager

Product getPackage empty

The package does not exist on that panel, or the server row points at the wrong host. Create WFX-SH- / WFX-RH- on the panel, then reload the product form.

Payment OK, hosting still Pending

  1. Open /admin/automation/errors
  2. Common cPanel error: reserved username (names starting with test and similar). Set a new username on the hosting and run create
  3. Package name mismatch (spaces, case)
  4. Plesk: customer may already exist (User account already exists) while the domain was not created — create the domain against that client, then set hosting Active
  5. CWP: HTTP to port 2304 or XML key format — use https://…:2304 and JSON key

Plesk shared create

Plesk shared hosting: REST create client then domain. Reseller uses XML reseller/add with plan-name. If createClient returns nothing, inspect /api/v2/clients for an existing login.

DirectAdmin usernames

Max length 8. Observer truncates; collisions get the hosting id suffix.

Wallet pay disabled

Invoice wallet option requires deposit_module on general settings. Insufficient balance is a client-side error, not a module error.

SSL checkout errors

CSR and validation method are required on SSL cart lines.

Docs URL vs Knowledge Base

If /docs shows a directory listing or a CMS page, the rewrite in /docs/.htaccess or the Laravel route before /{slug} is missing.

Lorem ipsum dolor sit amet consectetur adipisicing elit consectetur adipisicing elit sit amet con m ipsum

Join thousands of developers, agencies, and businesses powered by WebFox.