---
name: "netplan-set"
section: "8"
platform: "linux"
package: "netplan"
version: "1.2.2-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/netplan-set"
---

# netplan-set(8)

write Netplan YAML configuration snippets to file

## NAME

`netplan-set` - write Netplan YAML configuration snippets to file

## SYNOPSIS

**netplan** \[*--debug*\] **set** **-h**\|**--help**

**netplan** \[*--debug*\] **set** \[*--root-dir=ROOT\_DIR*\] \[*--origin-hint=ORIGIN\_HINT*\] \[*key=value*\]

## DESCRIPTION

**netplan set \[key=value\]** writes a given key/value pair or YAML subtree into a YAML file in `/etc/netplan/` and validates its format.

You can specify a single value as: `"[network.]ethernets.eth0.addresses=[1.2.3.4/24, 5.6.7.8/24]"` or a full subtree as: `"[network.]ethernets.eth0={dhcp4: true, dhcp6: true}"`.

For details of the configuration file format, see [**netplan**(5)](/netplan/5.md).

## OPTIONS

- `-h`, `--help`

  Print basic help.

- `--debug`

  Print debugging output during the process.

- `--root-dir`

  Write YAML files into this root instead of `/`.

- `--origin-hint`

  Specify a name for the configuration file, e.g.: `70-netplan-set` =\> `/etc/netplan/70-netplan-set.yaml`.

## SEE ALSO

[**netplan**(5)](/netplan/5.md), [**netplan-get**(8)](/netplan-get/8.md), [**netplan-dbus**(8)](/netplan-dbus/8.md)

## AUTHORS

Lukas Märdian (lukas.maerdian@canonical.com).