nmstate.service - Man Page

Apply /etc/nmstate network states

Synopsis

nmstate.service

Description

nmstate.service invokes nmstatectl service command which apply all network state files ending with .yml in /etc/nmstate folder.

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]n
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]n
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.

Bug Reports

Report bugs on nmstate GitHub issues <https://github.com/nmstate/nmstate>.

See Also

nmstatectl(8)

Referenced By

nmstatectl(8).

April 18, 2025 2.2.44 nmstate.service man page