{
    "content": [
        {
            "type": "text",
            "text": "# netplan-apply(8) (man)\n\n**Summary:** netplan-apply - apply configuration from netplan YAML files to a running system\n\n**Synopsis:** netplan [--debug] apply -h | --help\nnetplan [--debug] apply\n\n## Flags\n\n| Flag | Long | Arg | Description |\n|------|------|-----|-------------|\n| -h | --help | — | Print basic help. |\n| — | --debug | — | Print debugging output during the process. |\n\n## See Also\n\n- netplan(5)\n- netplan-generate(8)\n- netplan-try(8)\n- udev(7)\n- systemd-networkd.service(8)\n- workManager(8)\n\n## Section Outline\n\n- **NAME** (2 lines)\n- **SYNOPSIS** (4 lines)\n- **DESCRIPTION** (18 lines)\n- **OPTIONS** (1 lines) — 2 subsections\n  - -h, --help (2 lines)\n  - --debug (2 lines)\n- **KNOWN ISSUES** (11 lines)\n- **SEE ALSO** (3 lines)\n- **AUTHORS** (5 lines)\n\n## Full Content\n\n### NAME\n\nnetplan-apply - apply configuration from netplan YAML files to a running system\n\n### SYNOPSIS\n\nnetplan [--debug] apply -h | --help\n\nnetplan [--debug] apply\n\n### DESCRIPTION\n\nnetplan apply applies the current netplan configuration to a running system.\n\nThe process works as follows:\n\n1. The backend configuration is generated from netplan YAML files.\n\n2. The  appropriate  backends (systemd-networkd(8) or NetworkManager(8)) are invoked to bring\nup configured interfaces.\n\n3. netplan apply iterates through interfaces that are still down, unbinding them  from  their\ndrivers, and rebinding them.  This gives udev(7) renaming rules the opportunity to run.\n\n4. If  any  devices  have  been rebound, the appropriate backends are re-invoked in case more\nmatches can be done.\n\nFor information about the generation step, see netplan-generate(8).  For details of the  con‐\nfiguration file format, see netplan(5).\n\n### OPTIONS\n\n#### -h, --help\n\nPrint basic help.\n\n#### --debug\n\nPrint debugging output during the process.\n\n### KNOWN ISSUES\n\nnetplan apply will not remove virtual devices such as bridges and bonds that have been creat‐\ned, even if they are no longer described in the netplan configuration.  That is  due  to  the\nfact that netplan operates statelessly and is not aware of the previously defined virtual de‐\nvices.\n\nThis can be resolved by manually removing the virtual device (for example ip link delete  dev\nbond0) and then running netplan apply, by rebooting, or by creating a temporary backup of the\nYAML state in /etc/netplan before modifying the configuration and passing this state to  net‐\nplan   (e.g.    mkdir  -p  /tmp/netplanstatebackup/etc  &&  cp  -r  /etc/netplan  /tmp/net‐\nplanstatebackup/etc/ then running netplan apply --state /tmp/netplanstatebackup)\n\n### SEE ALSO\n\nnetplan(5), netplan-generate(8), netplan-try(8), udev(7),  systemd-networkd.service(8),  Net‐‐\nworkManager(8)\n\n### AUTHORS\n\nDaniel Axtens (<daniel.axtens@canonical.com>).\n\n\n\nnetplan-apply(8)\n\n"
        }
    ],
    "structuredContent": {
        "command": "netplan-apply",
        "section": "8",
        "mode": "man",
        "summary": "netplan-apply - apply configuration from netplan YAML files to a running system",
        "synopsis": "netplan [--debug] apply -h | --help\nnetplan [--debug] apply",
        "flags": [
            {
                "flag": "-h",
                "long": "--help",
                "arg": null,
                "description": "Print basic help."
            },
            {
                "flag": "",
                "long": "--debug",
                "arg": null,
                "description": "Print debugging output during the process."
            }
        ],
        "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-try",
                "section": "8",
                "url": "https://www.chedong.com/phpMan.php/man/netplan-try/8/json"
            },
            {
                "name": "udev",
                "section": "7",
                "url": "https://www.chedong.com/phpMan.php/man/udev/7/json"
            },
            {
                "name": "systemd-networkd.service",
                "section": "8",
                "url": "https://www.chedong.com/phpMan.php/man/systemd-networkd.service/8/json"
            },
            {
                "name": "workManager",
                "section": "8",
                "url": "https://www.chedong.com/phpMan.php/man/workManager/8/json"
            }
        ],
        "section_outline": [
            {
                "name": "NAME",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "SYNOPSIS",
                "lines": 4,
                "subsections": []
            },
            {
                "name": "DESCRIPTION",
                "lines": 18,
                "subsections": []
            },
            {
                "name": "OPTIONS",
                "lines": 1,
                "subsections": [
                    {
                        "name": "-h, --help",
                        "lines": 2,
                        "flag": "-h",
                        "long": "--help"
                    },
                    {
                        "name": "--debug",
                        "lines": 2,
                        "long": "--debug"
                    }
                ]
            },
            {
                "name": "KNOWN ISSUES",
                "lines": 11,
                "subsections": []
            },
            {
                "name": "SEE ALSO",
                "lines": 3,
                "subsections": []
            },
            {
                "name": "AUTHORS",
                "lines": 5,
                "subsections": []
            }
        ]
    }
}