# Using OpenStack Baremetal

Before working with the Bare Metal service, you’ll need to create a connection to your OpenStack cloud by following the Connect user guide. This will provide you with the `conn` variable used in the examples below.

The primary resource of the Bare Metal service is the node.

Below are a few usage examples. For a reference to all the available methods, see Baremetal API.

## CRUD operations

### List Nodes

A node is a bare metal machine.

Full example: baremetal resource list

## Provisioning operations

Provisioning actions are the main way to manipulate the nodes. See Bare Metal service states documentation for details.

### Manage and inspect Node

Managing a node in the `enroll` provision state validates the management (IPMI, Redfish, etc) credentials and moves the node to the `manageable` state. Managing a node in the `available` state moves it to the `manageable` state. In this state additional actions, such as configuring RAID or inspecting, are available.

Inspecting a node detects its properties by either talking to its BMC or by booting a special ramdisk.

Full example: baremetal provisioning

### Provide Node

Providing a node in the `manageable` provision state makes it available for deployment.

Full example: baremetal provisioning

this page last updated: 2026-01-16 23:06:19

Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.