NETPLAN-TRY(8)

🎀 netplan-try(8) 🎀

okay so bestie, this is the netplan-try page from the System Manager's Manual, and it’s literally the “try it before you commit” vibe check for your network config. Manual name folded in right here instead of copying the header line, periodt. 💅

🌸 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 automatically rolls it back if the user does not confirm the configuration within a time limit. It’s giving safety net, ngl. 😭

A configuration can be confirmed or rejected interactively or by sending the SIGUSR1 or SIGINT signals.

This may be especially useful on remote systems, to prevent an administrator being permanently locked out of systems in the case of a network configuration error. Remote-admin main character energy, fr fr. 🫶

💅 OPTIONS 💅

• -h, --help — Print basic help. Simple, iconic, does what it says.
• --debug — Print debugging output during the process. For when you need the receipts. 🔥
• --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 seconds. Note that some network configurations (such as STP) may take over a minute to settle. So like, don’t rush the vibe check. 🌸

😭 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 cancelled, 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 configuration on disk is in the state you expect before rebooting!

⚠️ bestie, read that last bit again: verify the config on disk before you reboot. The drama is not worth it. 💀

🔥 SEE ALSO 🔥

netplan(5), netplan-generate(8), netplan-apply(8)

👑 AUTHORS 👑

Daniel Axtens (daniel.axtens@canonical.com).

🫶 and that’s the whole netplan-try(8) page from the System Manager's Manual — the footer didn’t print a version or date, so this is the cute sign-off instead. 💜