.\" Automatically generated by Pandoc 3.1.3
.\"
.\" Define V font for inline verbatim, using C font in formats
.\" that render this, and otherwise B font.
.ie "\f[CB]x\f[]"x" \{\
. ftr V B
. ftr VI BI
. ftr VB B
. ftr VBI BI
.\}
.el \{\
. ftr V CR
. ftr VI CI
. ftr VB CB
. ftr VBI CBI
.\}
.TH "netplan-apply" "8" "" "" ""
.hy
.SH NAME
.PP
netplan-apply - apply configuration from netplan YAML files to a running
system
.SH SYNOPSIS
.PP
\f[B]netplan\f[R] [--debug] \f[B]apply\f[R] -h | --help
.PP
\f[B]netplan\f[R] [--debug] \f[B]apply\f[R]
.SH DESCRIPTION
.PP
\f[B]netplan apply\f[R] applies the current netplan configuration to a
running system.
.PP
The process works as follows:
.IP "1." 3
The backend configuration is generated from netplan YAML files.
.IP "2." 3
The appropriate backends (\f[B]systemd-networkd\f[R](8) or
\f[B]NetworkManager\f[R](8)) are invoked to bring up configured
interfaces.
.IP "3." 3
\f[B]netplan apply\f[R] iterates through interfaces that are still down,
unbinding them from their drivers, and rebinding them.
This gives \f[B]udev\f[R](7) renaming rules the opportunity to run.
.IP "4." 3
If any devices have been rebound, the appropriate backends are
re-invoked in case more matches can be done.
.PP
For information about the generation step, see
\f[B]netplan-generate\f[R](8).
For details of the configuration file format, see \f[B]netplan\f[R](5).
.SH OPTIONS
.TP
-h, --help
Print basic help.
.TP
--debug
Print debugging output during the process.
.SH KNOWN ISSUES
.PP
\f[B]netplan apply\f[R] 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.
.PP
This can be resolved by manually removing the virtual device (for
example \f[V]ip link delete dev bond0\f[R]) and then running
\f[B]netplan apply\f[R], by rebooting, or by creating a temporary backup
of the YAML state in \f[V]/etc/netplan\f[R] before modifying the
configuration and passing this state to netplan (e.g.
\f[V]mkdir -p /tmp/netplan_state_backup/etc && cp -r /etc/netplan /tmp/netplan_state_backup/etc/\f[R]
then running \f[B]netplan apply --state /tmp/netplan_state_backup\f[R])
.SH SEE ALSO
.PP
\f[B]netplan\f[R](5), \f[B]netplan-generate\f[R](8),
\f[B]netplan-try\f[R](8), \f[B]udev\f[R](7),
\f[B]systemd-networkd.service\f[R](8), \f[B]NetworkManager\f[R](8)
.SH AUTHORS
Daniel Axtens (<daniel.axtens@canonical.com>).