netplan-apply(8) netplan-apply(8)
NAME
netplan-apply - apply configuration from netplan YAML files to a run-
ning system
SYNOPSIS
netplan [--debug] apply -h | --help
netplan [--debug] apply
DESCRIPTION
netplan apply applies the current netplan configuration to a running
system.
The process works as follows:
1. The backend configuration is generated from netplan YAML files.
2. The appropriate backends (systemd-networkd(8) or NetworkManager(8))
are invoked to bring up configured interfaces.
3. netplan apply iterates through interfaces that are still down, un-
binding them from their drivers, and rebinding them. This gives
udev(7) renaming rules the opportunity to run.
4. If any devices have been rebound, the appropriate backends are re-
invoked in case more matches can be done.
For information about the generation step, see netplan-generate(8).
For details of the configuration file format, see netplan(5).
OPTIONS
-h, --help
Print basic help.
--debug
Print debugging output during the process.
KNOWN ISSUES
netplan apply will not remove virtual devices such as bridges and bonds
that have been created, even if they are no longer described in the
netplan configuration. That is due to the fact that netplan operates
statelessly and is not aware of the previously defined virtual devices.
This can be resolved by manually removing the virtual device (for exam-
ple ip link delete dev bond0) and then running netplan apply, by re-
booting, or by creating a temporary backup of the YAML state in
/etc/netplan before modifying the configuration and passing this state
to netplan (e.g. mkdir -p /tmp/netplan_state_backup/etc && cp -r
/etc/netplan /tmp/netplan_state_backup/etc/ then running netplan apply
--state /tmp/netplan_state_backup)
SEE ALSO
netplan(5), netplan-generate(8), netplan-try(8), udev(7), systemd-net-
workd.service(8), NetworkManager(8)
AUTHORS
Daniel Axtens (<daniel.axtens@canonical.com>).
netplan-apply(8)
Generated by dwww version 1.14 on Fri Dec 5 05:48:48 CET 2025.