---
name: "nmstate-autoconf"
section: "8"
platform: "linux"
package: "nmstate"
version: "2.2.62-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/nmstate-autoconf"
---

# nmstate-autoconf(8)

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

## NAME

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

## SYNOPSIS

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

## 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

- **--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

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

## BUG REPORTS

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

## COPYRIGHT

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

## SEE ALSO

**[NetworkManager(8)](/NetworkManager/8.md)**