After installing the WHMCS module, you need to add your Opterius Panel as a server in WHMCS. This is the connection record WHMCS uses when it calls the Opterius API to create, suspend, or delete accounts.
Adding the Server
In WHMCS admin: Setup → Products/Services → Servers → Add New Server.
Fill in the fields:
| Field | Value |
|---|---|
| Name | A label for your own reference, e.g. Opterius Main |
| Hostname | Your Panel's IP address or domain (without https:// or port) |
| Module | Opterius |
| Username | Your Panel admin email address |
| Password | Your Panel admin password, or an API key if you have configured API key authentication |
| Secure (HTTPS) | Yes — always enable |
| Port | 8443 |
Note: The hostname field should be just the IP or domain — e.g.,
panel.yourdomain.comor203.0.113.5. Do not include the protocol or port in this field. WHMCS constructs the full URL from the hostname, port, and secure toggle.
Name Servers
Set the name servers WHMCS will display to clients for domains provisioned on this server:
| Field | Example |
|---|---|
| Name Server 1 | ns1.yourdomain.com |
| Name Server 2 | ns2.yourdomain.com |
These values are shown to clients in their WHMCS client area after account creation. They should match the actual nameservers configured for accounts on this Panel — set these in Server Mode → Settings → DNS on the Panel side.
Testing the Connection
Click Test Connection after saving. WHMCS makes a call to the Opterius API and reports success or an error.
Common failure reasons:
| Error | Likely cause |
|---|---|
| Connection refused | Wrong port, firewall blocking 8443, or Panel not running |
| SSL certificate error | Panel using a self-signed cert — use a valid cert or configure WHMCS to accept it |
| Authentication failed | Wrong admin email or password; check credentials in Panel |
| API access disabled | Enable the API in Security Settings |
If you have an admin IP allowlist configured in Security Settings, add the WHMCS server's IP to the allowlist or API calls from WHMCS will be rejected.
Multiple Servers
You can add multiple Opterius servers in WHMCS — one entry per Panel. When configuring WHMCS products, assign each product to a server group, and put the appropriate Panel in that server group. WHMCS will route provisioning requests to the correct Panel.