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 network state file will be renamed with the suffix .applied after applying it. This is to prevent it being applied again when the service runs next.

With /etc/nmstate/nmstate.conf holding below content:

[service]n
keep_state_file_after_apply = true

The nmstate.service will not remove network state file, just copy applied network stata to file with the suffix .applied after applying it.

By default, nmstate merge 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).

March 05, 2025 2.2.42 nmstate.service man page