Vultr Bare Metal Manager for WISECP: installation guide
Module folder: VultrMetal (WISECP v5). Provisions, manages and bills Vultr bare metal servers.
Requirements
- WISECP v5 with PHP 8.2+ and the cURL extension.
- A Vultr API key (Vultr portal > Account > API). If the key has an access control list, allow the IP address of your WISECP server.
- A license key for this module.
1. Upload the module
Copy the VultrMetal folder to coremio/modules/Servers/VultrMetal/ on your WISECP installation.
2. Add the Vultr server record
- Go to Products > Server Settings > Add New Server.
- Open the Dedicated tab and choose Vultr Bare Metal Manager.
- Enter the Vultr API key. The address, username and password fields are not used by this module: enter any value (for example
api.vultr.com,api,x). - Enter a name in Hostname, press Test Connection (it must show Connection verified), then Add New Server.
3. Activate the license
Go to Products > Hosting & Servers > Vultr Bare Metal (admin console), open the License tab, paste the license key and press Save. The status must read Active.
The other tabs: Account (Vultr account summary), Servers (list, link a server to a service), Plans (import plans as products, sync prices), Operating Systems (choose which systems customers may install), Logs, Settings (price margin, currency rates, template product).
4. Create a product
-
Products > Create New Product: type Servers, pick a group, give it a name, set Module Assignment to Vultr Bare Metal Manager, press Continue.
-
On the Automation tab choose Single Server = the server record from step 2. The module settings appear:
- Region, Plan (only plans offered in that region are listed; RAM and disks in GB, price per month), Default operating system.
- Hostname prefix, IPv6 by default.
- Allow customers to use the console, Allow customers to edit user data.
- Delete the server at Vultr on cancellation (on by default; only servers ordered by this module are ever deleted, and deletion cannot be undone).
- Default user data script (first-boot script, max 16 KB; tokens
{hostname},{serviceid}).
-
On Pricing enable a billing cycle and set the price, then Save Changes.
Tip: after the first product exists, use the admin console Plans tab to create more products from Vultr plans and to keep their prices in step with Vultr.
5. Order and provisioning
Orders create the server at Vultr. A bare metal server takes about 4 to 10 minutes to deploy, so the service stays In Progress with the message "Server ... is being deployed by Vultr". The cron job Pending Vultr bare metal order sync (every minute, make sure the WISECP cron is running) links the server and activates the service when it is ready. Staff can also press Retry on the service. Pressing Retry never orders a second server.
6. What customers and staff can do
Overview with live status, hardware, IP, location and bandwidth; power actions; reinstall; console; IPv6; bandwidth usage; server options.
| Tool | Notes |
|---|---|
| Start / Stop / Restart | Stop is a hard power off. Only the applicable buttons are shown. |
| Reinstall OS | Erases the server. Refused for customers while the server is locked. ![]() |
| VNC Console | Opens Vultr's console in a new window. ![]() |
| IPv6 Management | Enable IPv6 (Vultr cannot remove it again). ![]() |
| Bandwidth Usage | Outbound traffic counts against the plan allowance. ![]() |
| Server Options | Lock, label, IPv6, VPC networks, user data. ![]() |
| Activity Log | Staff only. ![]() |
7. Cancelling
Cancelling a service deletes the server at Vultr only when this module ordered it and the product option is on. Servers imported or linked by hand are never deleted by WISECP.
8. Import and link existing servers
- Import accounts in WISECP lists the Vultr servers; imported services are linked by their Vultr server ID.
- In the admin console Servers tab you can link an unlinked server to a service that has no server yet.
Not supported
- Plan change (Vultr has no bare metal plan change): upgrades show an explanatory error.
- Snapshots, firewall groups, backups, ISO: Vultr offers none of these for bare metal.





