operations/netplan.md

# using netplan

Netplan is the replacement for the non-deterministic `/etc/network/interfaces` that Debian *still* uses. It uses YAML format configuration files to configure your network.

It works remarkably well, and isn't cryptic to read like the `interfaces` rules.

## Examples

Here are some examples

### VLAN Tagged network

This configuration is an example from hydra

```
network:
  version: 2
  ethernets:
    enp65s0:
      dhcp4: false
      addresses: []
    enp2s0f0:
      dhcp4: false
      addresses: []
    enp2s0f1:
      dhcp4: false
      addresses: []
  bridges:
    br2:
      dhcp4: false
      addresses: [ 128.153.145.42/23 ]
      gateway4: 128.153.145.1
      nameservers:
        addresses: [ 128.153.145.3, 8.8.8.8 ]
        search: [ cslabs.clarkson.edu ]
      interfaces: [ v2_cosi_priv ]
    br4:
      dhcp4: false
      addresses: [ 128.153.146.42/24 ]
      interfaces: [ v4_cosi_146 ]
    br5:
      dhcp4: false
      interfaces: [ v5_cosi_voip ]
  vlans:
    v2_cosi_priv:
      id: 2
      link: enp65s0
    v4_cosi_146:
      id: 4
      link: enp65s0
    v5_cosi_voip:
      id: 5
      link: enp65s0
```