# `baremetal` Standalone Command-Line Interface (CLI)

## Synopsis

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

baremetal help <command>

## Description

The standalone `baremetal` tool allows interacting with the Bare Metal service without installing the OpenStack Client tool as in openstack baremetal Command-Line Interface (CLI).

The standalone tool is mostly identical to its OSC counterpart, with two exceptions:

1. No need to prefix commands with `openstack`.

2. No authentication is assumed by default.

Check the OSC CLI reference for a list of available commands.

### Inspector support

The standalone `baremetal` tool optionally supports the low-level bare metal introspection API provided by ironic-inspector. If ironic-inspector-client is installed, its commands are automatically available (also without the `openstack` prefix).

### Standalone usage

To use the CLI with a standalone bare metal service, you need to provide an endpoint to connect to. It can be done in three ways:

1. Provide an explicit `--os-endpoint` argument, e.g.:

       $ baremetal --os-endpoint https://ironic.host:6385 node list

2. Set the corresponding environment variable, e.g.:

       $ export OS_ENDPOINT=https://ironic.host:6385
       $ baremetal node list

3. Populate a clouds.yaml file, setting `baremetal_endpoint_override`, e.g.:

       $ cat ~/.config/openstack/clouds.yaml
       clouds:
         ironic:
           auth_type: none
           baremetal_endpoint_override: http://127.0.0.1:6385
       $ export OS_CLOUD=ironic
       $ baremetal node list

### Usage with OpenStack

The standalone CLI can also be used with the Bare Metal service installed as part of OpenStack. See Authentication for information on the required input.

this page last updated: 2026-03-26 21:20:19

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

found an error? report a bug