Overview
A server in Commerce represents one hosting panel instance — an Opterius Panel install, a cPanel server, or any other panel with a provisioning module. Commerce provisions hosting accounts onto servers. You must add at least one server before any hosting product can be provisioned.
Location: Admin → Infrastructure → Servers → Add Server
Step-by-Step
1. Basic Details
| Field | Description |
|---|---|
| Name | Internal label shown in the admin UI only (e.g. "EU Shared #1") |
| Module Type | Card picker listing all registered provisioning modules |
| Hostname | Human-readable hostname of the server (informational) |
| Max Accounts | Maximum number of hosting accounts this server should hold |
Max Accounts is used by the load balancer to determine available capacity. Set it to the practical limit for your server specs.
2. Select a Module
Clicking a module card updates the form to show that module's credential fields. Fields are defined by the module's moduleFields() method and vary per module type.
Opterius Panel fields:
| Field | Description |
|---|---|
api_url |
Base URL of the Panel API, e.g. https://panel.example.com |
api_token |
The API token from Panel → Settings → API |
Other modules will show their own fields (username, password, API key, etc.).
3. Credential Fields — Secret Values
Fields marked as secret (passwords, tokens) are rendered as masked inputs. On edit:
- Leave the field blank to keep the existing stored value.
- Enter a new value to replace it.
Secret values are never echoed back to the browser after initial save.
4. Test Connection
Before saving, click Test Connection. Commerce calls the module's testConnection() method and shows an inline result:
- Success — credentials are valid and the Panel is reachable. Proceed to save.
- Failure — an error is shown inline. Fix the credentials or check network access before saving.
Always test before saving. A server record with bad credentials will cause all provisioning jobs to fail silently until the log is checked.
5. Assign to a Server Group
Select a Server Group from the dropdown. The server will only be eligible for provisioning once it belongs to a group that is linked to at least one product.
If no groups exist yet, create one first at Admin → Infrastructure → Server Groups, then return to add the server.
Editing a Server
Go to Admin → Infrastructure → Servers → click the server name. All fields are editable. Secret fields are blank on load — leave blank to keep existing value, or enter a new value to rotate credentials.
After rotating credentials, click Test Connection on the edit form to verify the new values before saving.
Deleting a Server
A server cannot be deleted while it has active services. Reassign or terminate all services on the server first.