Common problems with billing modules and panel accounts, with what the message means and what to check. The billing modules show the panel's own sentence followed by "(request
Billing module cannot connect#
| Message | Cause and fix |
|---|---|
| "The key belongs to a user account; use an administrator's or a reseller's key." | Make the key while signed in as an administrator or reseller (API key for a billing system). |
| "Missing scopes the module uses: …" | Edit the key under Settings › API keys and tick the scopes listed, or choose the Billing system preset. |
| "Placement: locations only; add infrastructure:read to list node groups and nodes." | Not an error. Tick infrastructure:read on an administrator's key to choose node groups or nodes. |
HTTP 403 ip_not_allowed |
The billing server's address is not in the key's allowed addresses, the account's API list or the administrators' API list (System › Settings › Sign-in). Add its public address. |
| A TLS or certificate error | The modules use HTTPS only and verify the certificate. Give the panel a valid certificate (Cloudflare and certificates); a self-signed one is refused. |
| "The panel answered HTTP 401." | The key was revoked, expired, or copied incompletely. Make a new one. |
Orders fail to provision#
| Message | Fix |
|---|---|
| "Choose a plan in the product's module settings (or a Plan configurable option)." (also placement, image) | Fill in the product's module settings, or the matching configurable option. |
| "… has no node with room for this server." / "This location has no room for a server of this size right now." | No online node in that placement has the memory, disk or a free address. Add capacity or IP pool addresses (IP pools), or choose another placement. |
| "Your provider's limit has been reached." or a limit sentence | The reseller's pool is full (reseller pools). Raise the limit on the reseller's page. |
| "A panel account with this email address belongs to another billing client." | A panel account with that email is linked to another client ID. Change one of the emails, or clear that account's external ID in the panel if the link is wrong. |
| "A panel account with this email address is an administrator or reseller account, …" | Staff accounts cannot hold customer servers. Use another email for the billing client. |
| "The server is still being set up, so its extra IPv4 addresses … could not be changed yet." | Run Create (or Change Package) again in a minute. It does not make a second server. |
| "The order has extra disks but no disk space: …" | Add an Extra Disk Space option to the product. |
| "Unknown field: setup" (422) | The panel is older than the module's customer-setup feature. Update the panel or turn off Customer sets up the server. |
| "The panel only upgrades: … has less memory than this server." | Downgrades are not supported. Move the client back to the old package, or create a new service. |
| "Several panel servers carry this service's ID." | Put the right server's ID in the service's server ID field (vmstack_server_id in WHMCS). |
| "The panel server stored in this service belongs to another account than this client's." | The stored server ID is wrong, or the server was given to another owner in the panel. Correct the field or the owner. |
A create that timed out in the billing system usually still made the server: run Create again; it finds the server by the service's ID and finishes.
Single sign-on and console links fail#
The customer sees "This sign-in link does not work any more: it was used, it expired, or it was opened from another address."
- Links are valid for 60 seconds and once. A browser that prefetches links, or a customer who double-clicks, uses it up: open the control panel again from the billing system.
- With Bind sign-in links to the client's address on, the link works only from the address the billing system saw. Customers behind changing proxies, mobile networks, or reaching the billing system over IPv4 and the panel over IPv6 fail. Turn the setting off for the product.
- An account's own panel allowlist and address bans apply to links as well.
- Two-factor still applies: an account with an authenticator app is asked for its code after the link.
- Links are never made for administrators, suspended or invited accounts.
Customers see greyed buttons or "Your plan does not include …"#
A customer switch is off for the plan, the account, the server, or for all customers of its reseller. Open the server's Manage tab: each switch says what results and why ("Not allowed: the plan."). "Your role on this account (Read-only) does not allow this." means the person is a team member with a read-only role.
"You have used the N reinstalls your plan includes this month." is the plan's reinstall limit; staff acting as themselves are not limited.
A reseller or user cannot create servers#
- The user needs May create and delete servers on its account.
- A reseller with no locations ticked cannot create servers anywhere.
- A reseller without plans is sent to Hosting plans; its users read "Your provider has not set up any plans yet."
- A plan marked Too large is bigger than the reseller's pool; change the plan or the limit.
- Users of a suspended reseller cannot get new servers: "New servers cannot be created for this account right now. Contact your provider."
Invitations and mails do not arrive#
Team invitations, invite links and password reset links need mail. Check System › Settings › Mail (Send test mail) and System › Mail log. While mail is off, set an account's password from its page with Set a new password instead. Invite links last 72 hours and team invitations 7 days; Send the link again or a new invitation replaces the old one.
Locked out#
- "Too many failed sign-ins. Try again in N minutes." is a ban of the account or the address. Another administrator lifts it under System › Sign-in log › Bans in force, or run
vmstack:sign-in-unlockon the panel's server (Unlocking from the shell). - Everyone is banned at once, or the log shows the same address for every sign-in: the panel sees the proxy's address. Make the tunnel or reverse proxy send
X-Forwarded-For. - Signed out right after signing in, or "not in the list": an allowed-address list does not include your address. Use
vmstack:sign-in-unlock --clear-admin-allowlistor--user=EMAIL. - Signed out after a few minutes: an idle or absolute timeout is set under System › Settings › Sign-in, or by your staff role.
Lost two-factor device#
- At the two-factor prompt, use one of the recovery codes instead of a code, or sign in with a passkey if the account has one. Then set up the authenticator again under Settings › Security.
- Without either, the panel has no button to remove another account's second factor. Clear it on the panel's server with the command in Recovery commands, after making sure the request really comes from the account's owner.
Reseller brand or domain not shown#
- The brand shows only while Its own brand is ticked on the reseller's page and the brand has a name.
- A reseller's own domain shows the brand only when requests for that name actually reach the panel with that Host header: check the DNS record and that your web server or tunnel serves the name with a certificate. The panel does not issue certificates for it.
- "Failing since …" on the reseller's Mail page: its own SMTP server refused or could not be reached. Mails are meanwhile sent through the panel's mail (
panel_fallbackin the Mail log). Fix the settings and Send a test to myself.