nmstate-autoconf(8) nmstate-autoconf man page nmstate-autoconf(8)

# [NAME](#NAME)

nmstate-autoconf - A nmstate command line tool to automatically configure the network state using LLDP information

# [SYNOPSIS](#SYNOPSIS)

**nmstate-autoconf \[*INTERFACE\_NAME*] \[--dry-run]**

# [DESCRIPTION](#DESCRIPTION)

**nmstate-autoconf is a command line tool that uses *libnmstate* in order to** confgure the network state automatically using LLDP information. This tool is experimental only.

*nmstate-autoconf* will identify the interfaces connected to a VLAN and unify them in a bond interface. In addition, a vlan interface will be created in top of the bond.

The bond state will be the following one:

\- name: bond50  
type: bond  
state: up  
link-aggregation:  
mode: balance-rr  
port:  
\- enp4s0  
\- enp4s0d1

The host VLAN state will be the following one:

\- name: prod-net  
type: vlan  
state: up  
vlan:  
base-iface: bond50  
id: 50

For multiple interface names, use comma to separate them. You can also use patterns for interface names:

*** matches everything**  
**? matches any single character**  
**\[seq] matches any character in seq**  
**\[!seq] matches any character not in seq**

For example, to enable LLDP auto configuration on all interfaces starts with eth:

nmstate-autoconf eth\\*  
\# The backslash is required to stop shell expanding '\*' to file names.

# [OPTIONS](#OPTIONS)

**--dry-run, -d**

Generate the network state that is going to be applied and print it out. It won't apply any changes in the host.

# [LIMITATIONS](#LIMITATIONS)

\* This tool is experimental only. * It is not possible to configure automatically bond or vlan options.

# [BUG REPORTS](#BUG_REPORTS)

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

# [COPYRIGHT](#COPYRIGHT)

License Apache-2.0 <https://www.apache.org/licenses/LICENSE-2.0>

# [SEE ALSO](#SEE_ALSO)

[**NetworkManager(8)**](/man/enterprise-packages/nmstate/NetworkManager.8)

November 6, 2026 2.2.62

---

Document: nmstate-autoconf(8) from nmstate 2.2.62-r0 (Chainguard OS)