nmstate.service8

Usage

Overview

nmstate.service invokes nmstatectl service command which apply all network state files ending with .yml or .yaml in /etc/nmstate folder. When two files holding the same name but one with `.yml` and another with `.yaml`, nmstate will not apply any but fail the service.

By default, the service renames the network state file to a name with suffix .applied after processing the file. This prevents applying the same file again when the service runs next.

Alternatively, you can set the following in /etc/nmstate/nmstate.conf:

[service]0
keep_state_file_after_apply = true

With keep_state_file_after_apply = true, the service copies the network state file to a file with .applied, but preserves the original file.

By default, nmstate merges network state file with current network state, if you want to override interface settings without merging, please set `override_iface = true` in `[service]` section in /etc/nmstate/nmstate.conf:

[service]0
override_iface = true

If `override_iface = true`, for network state to apply, nmstate.service will:

* For `interfaces` section, any defined interface will be configured by
desired state information only, undefined properties of this interface will
use default value instead of merging from current state.

* For other sections, no changes to their original behavior.

For example, if desired interface has no IPv4 section defined, nmstate will treat it as disabled regardless current network status.