Bare Metal Management

This guide provides an overview of management options for your bare metal servers. You can control your dedicated hardware through the Control Panel, REST API, or ics-cli. For detailed instructions on specific commands and actions, refer to the linked pages in the Server Actions section below.

Inventory

To get started, visit the Bare Metal Servers dashboard in the Control Panel. Here you’ll find a consolidated list of your bare metal server inventory, showing:

• Hostname
• Primary IP address
• Data center location
• Service ID
• Friendly name
• Status

Use the search box to narrow down by name, location, service, or IP.

Management Interfaces

You can manage your bare metal servers through three primary interfaces:

Console

The Console provides a graphical interface for managing servers. To access individual server functions:

1. In the left navigation bar, select Bare Metal Servers under Services.
2. Click on the server hostname to access the detailed server view.
3. Use the Server Actions dropdown menu in the top right of the page for management operations.

API

For complete bare metal server management API documentation, refer to our Bare Metal API Reference.

Common workflow example:

# 1. List server inventory
curl --request GET \
--url https://api.ingenuitycloudservices.com/rest-api/servers \
--header 'Accept: application/json' \
--header 'X-Api-Token: API_KEY'

# 2. Power on a specific server
curl --request POST \
--url https://api.ingenuitycloudservices.com/rest-api/servers/{server-id}/power/on \
--header 'Accept: application/json' \
--header 'X-Api-Token: API_KEY'

CLI

The ics-cli command-line tool offers streamlined management capabilities:

❯ ics-cli baremetal --help
Create, Destroy and Manage Bare Metal Servers

Usage:
ics-cli baremetal [command]

Available Commands:
custompxe    Specify a custom PXE boot URL to load your preferred network boot environment
deploy       Deploy a new Bare Metal server
friendlyname Set a friendly name for a server
get          Get the information of a Bare Metal Server by its Service ID
ikvm         Generate an IPMI IKVM Console URL
list         List all baremetal servers in your account
oslist       Get a list of operating systems available for a server
poweroff     Power off a baremetal server
poweron      Power on a baremetal server
reboot       Reboot a baremetal server
recovery     Boot a baremetal server into a recovery image
reinstall    Reinstall the operating system on a Bare Metal Server
sol          Generate a Serial Over LAN (SOL) session

Common workflow example:

# 1. List your servers to find the service ID
❯ ics-cli baremetal list

# 2. Power on a specific server using the service ID
❯ ics-cli baremetal poweron 1234567

# 3. Open an interactive server console
❯ ics-cli baremetal ikvm 1234567

Server Actions

The table below provides an overview of available server management actions across our platform:

Action	Description
Power Actions	Control server power state (power on, power off, reboot)
Remote Access / IPMI	Access server via IKVM (graphical) or SOL (serial console)
Boot to Rescue	Launch recovery environment for troubleshooting
OS Reload	Install a new operating system, erasing all existing data
Custom PXE Boot	Boot custom operating systems using network PXE
Assign SSH Keys	Control which SSH keys are deployed during OS installation