netplan-try(8) netplan-try(8)
NAME
netplan-try - try a configuration, optionally rolling it back
SYNOPSIS
netplan [--debug] try -h | --help
netplan [--debug] try [--config-file CONFIG_FILE] [--timeout TIMEOUT]
DESCRIPTION
netplan try takes a netplan(5) configuration, applies it, and automati-
cally rolls it back if the user does not confirm the configuration
within a time limit.
A configuration can be confirmed or rejected interactively or by send-
ing the SIGUSR1 or SIGINT signals.
This may be especially useful on remote systems, to prevent an adminis-
trator being permanently locked out of systems in the case of a network
configuration error.
OPTIONS
-h, --help
Print basic help.
--debug
Print debugging output during the process.
--config-file CONFIG_FILE
In addition to the usual configuration, apply CONFIG_FILE. It
must be a YAML file in the netplan(5) format.
--timeout TIMEOUT
Wait for TIMEOUT seconds before reverting. Defaults to 120 sec-
onds. Note that some network configurations (such as STP) may
take over a minute to settle.
KNOWN ISSUES
netplan try uses similar procedures to netplan apply, so some of the
same caveats apply around virtual devices.
There are also some known bugs: if netplan try times out or is can-
celled, make sure to verify if the network configuration has in fact
been reverted.
As with netplan apply, a reboot should fix any issues. However, be
sure to verify that the config on disk is in the state you expect be-
fore rebooting!
SEE ALSO
netplan(5), netplan-generate(8), netplan-apply(8)
AUTHORS
Daniel Axtens (<daniel.axtens@canonical.com>).
netplan-try(8)
Generated by dwww version 1.14 on Mon Nov 3 17:27:35 CET 2025.