{
    "mode": "man",
    "parameter": "netplan-try",
    "section": "8",
    "url": "https://www.chedong.com/phpMan.php/man/netplan-try/8/json",
    "generated": "2026-05-30T07:08:20Z",
    "synopsis": "netplan [--debug] try -h | --help\nnetplan [--debug] try [--config-file CONFIGFILE] [--timeout TIMEOUT]",
    "sections": {
        "NAME": {
            "content": "netplan-try - try a configuration, optionally rolling it back\n",
            "subsections": []
        },
        "SYNOPSIS": {
            "content": "netplan [--debug] try -h | --help\n\nnetplan [--debug] try [--config-file CONFIGFILE] [--timeout TIMEOUT]\n",
            "subsections": []
        },
        "DESCRIPTION": {
            "content": "netplan  try takes a netplan(5) configuration, applies it, and automatically rolls it back if\nthe user does not confirm the configuration within a time limit.\n\nA configuration can be confirmed or rejected interactively or by sending the SIGUSR1 or  SIG‐\nINT signals.\n\nThis may be especially useful on remote systems, to prevent an administrator being permanent‐\nly locked out of systems in the case of a network configuration error.\n",
            "subsections": []
        },
        "OPTIONS": {
            "content": "",
            "subsections": [
                {
                    "name": "-h, --help",
                    "content": "Print basic help.\n",
                    "flag": "-h",
                    "long": "--help"
                },
                {
                    "name": "--debug",
                    "content": "Print debugging output during the process.\n\n--config-file CONFIGFILE\nIn addition to the usual configuration, apply CONFIGFILE.  It must be a YAML file  in\nthe netplan(5) format.\n\n--timeout TIMEOUT\nWait  for  TIMEOUT seconds before reverting.  Defaults to 120 seconds.  Note that some\nnetwork configurations (such as STP) may take over a minute to settle.\n",
                    "long": "--debug"
                }
            ]
        },
        "KNOWN ISSUES": {
            "content": "netplan try uses similar procedures to netplan apply, so  some  of  the  same  caveats  apply\naround virtual devices.\n\nThere are also some known bugs: if netplan try times out or is cancelled, make sure to verify\nif the network configuration has in fact been reverted.\n\nAs with netplan apply, a reboot should fix any issues.  However, be sure to verify  that  the\nconfig on disk is in the state you expect before rebooting!\n",
            "subsections": []
        },
        "SEE ALSO": {
            "content": "netplan(5), netplan-generate(8), netplan-apply(8)\n",
            "subsections": []
        },
        "AUTHORS": {
            "content": "Daniel Axtens (<daniel.axtens@canonical.com>).\n\n\n\nnetplan-try(8)",
            "subsections": []
        }
    },
    "summary": "netplan-try - try a configuration, optionally rolling it back",
    "flags": [
        {
            "flag": "-h",
            "long": "--help",
            "arg": null,
            "description": "Print basic help."
        },
        {
            "flag": "",
            "long": "--debug",
            "arg": null,
            "description": "Print debugging output during the process. --config-file CONFIGFILE In addition to the usual configuration, apply CONFIGFILE. 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."
        }
    ],
    "examples": [],
    "see_also": [
        {
            "name": "netplan",
            "section": "5",
            "url": "https://www.chedong.com/phpMan.php/man/netplan/5/json"
        },
        {
            "name": "netplan-generate",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/netplan-generate/8/json"
        },
        {
            "name": "netplan-apply",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/netplan-apply/8/json"
        }
    ]
}