OpenStack Client Command-Line Interface (CLI)

OpenStack Client Command-Line Interface (CLI)


openstack [options] baremetal <command> [command-options]

openstack help baremetal <command>


The OpenStack Client plugin interacts with the Bare Metal service through the openstack baremetal command line interface (CLI).

To use openstack CLI, the OpenStackClient should be installed:

# pip install python-openstackclient

To use the CLI, you must provide your OpenStack username, password, project, and auth endpoint. You can use configuration options --os-username, --os-password, --os-project-id (or --os-project-name), and --os-auth-url, or set the corresponding environment variables:

$ export OS_USERNAME=user
$ export OS_PASSWORD=password
$ export OS_PROJECT_NAME=project                         # or OS_PROJECT_ID
$ export OS_PROJECT_DOMAIN_ID=default
$ export OS_USER_DOMAIN_ID=default
$ export OS_AUTH_URL=

This CLI is provided by python-openstackclient and osc-lib projects:

Getting help

To get a list of available (sub)commands and options, run:

$ openstack help baremetal

To get usage and options of a command, run:

$ openstack help baremetal <sub-command>


Get information about the openstack baremetal node create command:

$ openstack help baremetal node create

Get a list of available drivers:

$ openstack baremetal driver list

Enroll a node with “agent_ipmitool” driver:

$ openstack baremetal node create --driver agent_ipmitool --driver-info ipmi_address=

Get a list of nodes:

$ openstack baremetal node list

The baremetal API version can be specified via:

  • environment variable OS_BAREMETAL_API_VERSION:

    $ export OS_BAREMETAL_API_VERSION=1.25
  • or optional command line argument –os-baremetal-api-version:

    $ openstack baremetal port group list --os-baremetal-api-version 1.25
Creative Commons Attribution 3.0 License

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