// This is included in the following assemblies:
//
// * installing/installing_bare_metal/bare-metal-postinstallation-configuration.adoc

:_mod-docs-content-type: REFERENCE
[id="bmo-about-the-hostupdatepolicy-resource_{context}"]
= About the `HostUpdatePolicy` resource

[role="_abstract"]
You can use the `HostUpdatePolicy` resource to enable or disable applying live updates to the firmware settings, BMC settings, or firmware settings of each bare-metal host. By default, the Operator disables live updates to already provisioned bare-metal hosts by default.

The `HostUpdatePolicy` spec::

The `spec` section of the `HostUpdatePolicy` resource provides two settings:

`firmwareSettings`:: This setting corresponds to the `HostFirmwareSettings` resource.

`firmwareUpdates`:: This setting corresponds to the `HostFirmwareComponents` resource.

When you set the value to `onPreparing`, you can only update the host during provisioning, which is the default setting. When you set the value to `onReboot`, you can update a provisioned host by applying the resource and rebooting the bare-metal host. Then, follow the procedure for editing the `HostFirmwareSettings` or `HostFirmwareComponents` resource.

.Example `HostUpdatePolicy` resource
[source,yaml]
----
apiVersion: metal3.io/v1alpha1
kind: HostUpdatePolicy
metadata:
  name: <hostname>
  namespace: openshift-machine-api
spec:
  firmwareSettings: <setting>
  firmwareUpdates: <setting>
----
where:
--
`<hostname>`:: Specifies the name of the bare-metal host.
`spec.firmwareSettings`:: Specifies the update policy setting. Specify `onPreparing` to disable live updates. Specify `onReboot` to enable live updates.
--
