netplan-apply - apply configuration from Netplan YAML files to a running system
Contents
Description
netplanapply applies the current Netplan configuration to a running system.
The process works as follows:
1. The back-end configuration is generated from Netplan YAML files.
2. The appropriate back ends (systemd-networkd(8) or NetworkManager(8)) are invoked to bring up
configured interfaces.
3. netplanapply iterates through interfaces that are still down, unbinding 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 back ends 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).
Known Issues
netplanapply 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 example ip link delete dev bond0) and
then running netplan apply, by rebooting, 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).
Name
netplan-apply - apply configuration from Netplan YAML files to a running system
Options
-h, --help
Print basic help.
--debug
Print debugging output during the process.
See Also
netplan(5), netplan-generate(8), netplan-try(8), udev(7), systemd-networkd.service(8), NetworkManager(8)
Synopsis
netplan [--debug] apply-h|--helpnetplan [--debug] apply
