1netplan-apply(8)                                              netplan-apply(8)
2
3
4

NAME

6       netplan-apply  -  apply configuration from netplan YAML files to a run‐
7       ning system
8

SYNOPSIS

10       netplan [–debug] apply -h | –help
11
12       netplan [–debug] apply
13

DESCRIPTION

15       netplan apply applies the current netplan configuration  to  a  running
16       system.
17
18       The process works as follows:
19
20       1. The backend configuration is generated from netplan YAML files.
21
22       2. The  appropriate backends (systemd-networkd(8) or NetworkManager(8))
23          are invoked to bring up configured interfaces.
24
25       3. netplan apply iterates through interfaces that are still  down,  un‐
26          binding  them  from  their  drivers, and rebinding them.  This gives
27          udev(7) renaming rules the opportunity to run.
28
29       4. If any devices have been rebound, the appropriate backends  are  re-
30          invoked in case more matches can be done.
31
32       For  information  about  the  generation step, see netplan-generate(8).
33       For details of the configuration file format, see netplan(5).
34

OPTIONS

36       -h, –help
37              Print basic help.
38
39       –debug Print debugging output during the process.
40

KNOWN ISSUES

42       netplan apply will not remove virtual devices such as bridges and bonds
43       that  have  been  created,  even if they are no longer described in the
44       netplan configuration.  That is due to the fact that  netplan  operates
45       statelessly and is not aware of the previously defined virtal devices.
46
47       This can be resolved by manually removing the virtual device (for exam‐
48       ple ip link delete dev bond0) and then running netplan  apply,  by  re‐
49       booting,  or  by  creating  a  temporary  backup  of  the YAML state in
50       /etc/netplan before modifying the configuration and passing this  state
51       to  netplan  (e.g.   mkdir  -p  /tmp/netplan_state_backup/etc  && cp -r
52       /etc/netplan /tmp/netplan_state_backup/etc/ then running netplan  apply
53       –state /tmp/netplan_state_backup)
54

SEE ALSO

56       netplan(5),  netplan-generate(8), netplan-try(8), udev(7), systemd-net‐
57       workd.service(8), NetworkManager(8)
58

AUTHORS

60       Daniel Axtens (<daniel.axtens@canonical.com>).
61
62
63
64                                                              netplan-apply(8)