# Physical network The `physical` network type connects to an existing physical network, which can be a network interface or a bridge, and serves as an uplink network for OVN. This network type allows to specify presets to use when connecting OVN networks to a parent interface or to allow an instance to use a physical interface as a NIC. In this case, the instance NICs can simply set the `network`option to the network they connect to without knowing any of the underlying configuration details. ## Configuration options The following configuration key namespaces are currently supported for the `physical` network type: - `bgp` (BGP peer configuration) - `dns` (DNS server and resolution configuration) - `ipv4` (L3 IPv4 configuration) - `ipv6` (L3 IPv6 configuration) - `ovn` (OVN configuration) - `user` (free-form key/value for user metadata) #### NOTE LXD uses the [CIDR notation](https://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) where network subnet information is required, for example, `192.0.2.0/24` or `2001:db8::/32`. This does not apply to cases where a single address is required, for example, local/remote addresses of tunnels, NAT addresses or specific addresses to apply to an instance. The following configuration options are available for the `physical` network type: `bgp.peers.NAME.address` Peer address for use by `ovn` downstream networks [](#network-physical-network-conf:bgp.peers.NAME.address) | **Key:** | `bgp.peers.NAME.address` | |----------------|----------------------------| | **Type:** | string | | **Condition:** | BGP server | | **Scope:** | global | The address can be IPv4 or IPv6. `bgp.peers.NAME.asn` Peer AS number for use by `ovn` downstream networks [](#network-physical-network-conf:bgp.peers.NAME.asn) | **Key:** | `bgp.peers.NAME.asn` | |----------------|------------------------| | **Type:** | integer | | **Condition:** | BGP server | | **Scope:** | global | `bgp.peers.NAME.holdtime` Peer session hold time [](#network-physical-network-conf:bgp.peers.NAME.holdtime) | **Key:** | `bgp.peers.NAME.holdtime` | |----------------|-----------------------------| | **Type:** | integer | | **Default:** | `180` | | **Condition:** | BGP server | | **Required:** | no | | **Scope:** | global | Specify the peer session hold time in seconds. `bgp.peers.NAME.password` Peer session password for use by `ovn` downstream networks [](#network-physical-network-conf:bgp.peers.NAME.password) | **Key:** | `bgp.peers.NAME.password` | |----------------|-----------------------------| | **Type:** | string | | **Default:** | (no password) | | **Condition:** | BGP server | | **Required:** | no | | **Scope:** | global | `dns.nameservers` DNS server IPs on physical network [](#network-physical-network-conf:dns.nameservers) | **Key:** | `dns.nameservers` | |----------------|---------------------| | **Type:** | string | | **Condition:** | standard mode | | **Scope:** | global | Specify a list of DNS server IPs. `gvrp` Whether to use GARP VLAN Registration Protocol [](#network-physical-network-conf:gvrp) | **Key:** | `gvrp` | |--------------|----------| | **Type:** | bool | | **Default:** | `false` | | **Scope:** | global | This option specifies whether to register the VLAN using the GARP VLAN Registration Protocol. `ipv4.gateway` IPv4 address for the gateway and network [](#network-physical-network-conf:ipv4.gateway) | **Key:** | `ipv4.gateway` | |----------------|------------------| | **Type:** | string | | **Condition:** | standard mode | | **Scope:** | global | Use CIDR notation. `ipv4.ovn.ranges` IPv4 ranges to use for child OVN network routers [](#network-physical-network-conf:ipv4.ovn.ranges) | **Key:** | `ipv4.ovn.ranges` | |-------------|---------------------| | **Type:** | string | | **Scope:** | global | Specify a comma-separated list of IPv4 ranges in FIRST-LAST format. `ipv4.routes` Additional IPv4 CIDR subnets [](#network-physical-network-conf:ipv4.routes) | **Key:** | `ipv4.routes` | |----------------|-----------------| | **Type:** | string | | **Condition:** | IPv4 address | | **Scope:** | global | Specify a comma-separated list of IPv4 CIDR subnets that can be used with child OVN network forwarders, load-balancers and [`ipv4.routes.external`](https://canonical.com/lxd/docs/latest/reference/devices_nic/index.html.md#device-nic-ovn-device-conf:ipv4.routes.external) setting. `ipv4.routes.anycast` Whether to allow IPv4 routes on multiple networks/NICs [](#network-physical-network-conf:ipv4.routes.anycast) | **Key:** | `ipv4.routes.anycast` | |----------------|-------------------------| | **Type:** | bool | | **Default:** | `false` | | **Condition:** | IPv4 address | | **Scope:** | global | If set to `true`, this option allows the overlapping routes to be used on multiple networks/NICs at the same time. `ipv6.gateway` IPv6 address for the gateway and network [](#network-physical-network-conf:ipv6.gateway) | **Key:** | `ipv6.gateway` | |----------------|------------------| | **Type:** | string | | **Condition:** | standard mode | | **Scope:** | global | Use CIDR notation. `ipv6.ovn.ranges` IPv6 ranges to use for child OVN network routers [](#network-physical-network-conf:ipv6.ovn.ranges) | **Key:** | `ipv6.ovn.ranges` | |-------------|---------------------| | **Type:** | string | | **Scope:** | global | Specify a comma-separated list of IPv6 ranges in FIRST-LAST format. `ipv6.routes` Additional IPv6 CIDR subnets [](#network-physical-network-conf:ipv6.routes) | **Key:** | `ipv6.routes` | |----------------|-----------------| | **Type:** | string | | **Condition:** | IPv6 address | | **Scope:** | global | Specify a comma-separated list of IPv6 CIDR subnets that can be used with child OVN network forwarders, load-balancers and [`ipv6.routes.external`](https://canonical.com/lxd/docs/latest/reference/devices_nic/index.html.md#device-nic-ovn-device-conf:ipv6.routes.external) setting. `ipv6.routes.anycast` Whether to allow IPv6 routes on multiple networks/NICs [](#network-physical-network-conf:ipv6.routes.anycast) | **Key:** | `ipv6.routes.anycast` | |----------------|-------------------------| | **Type:** | bool | | **Default:** | `false` | | **Condition:** | IPv6 address | | **Scope:** | global | If set to `true`, this option allows the overlapping routes to be used on multiple networks/NICs at the same time. `mtu` MTU of the new interface [](#network-physical-network-conf:mtu) | **Key:** | `mtu` | |-------------|---------| | **Type:** | integer | | **Scope:** | global | `ovn.ingress_mode` How OVN NIC external IPs are advertised on uplink network [](#network-physical-network-conf:ovn.ingress_mode) | **Key:** | `ovn.ingress_mode` | |----------------|----------------------| | **Type:** | string | | **Default:** | `l2proxy` | | **Condition:** | standard mode | | **Scope:** | global | Possible values are `l2proxy` (proxy ARP/NDP) and `routed`. `parent` Existing interface to use for network [](#network-physical-network-conf:parent) | **Key:** | `parent` | |-------------|------------| | **Type:** | string | | **Scope:** | local | `user.*` User-provided free-form key/value pairs [](#network-physical-network-conf:user.*) | **Key:** | `user.*` | |-------------|------------| | **Type:** | string | | **Scope:** | global | `vlan` VLAN ID to attach to [](#network-physical-network-conf:vlan) | **Key:** | `vlan` | |-------------|----------| | **Type:** | integer | | **Scope:** | global | ## Supported features The following features are supported for the `physical` network type: - [How to configure LXD as a BGP server](https://canonical.com/lxd/docs/latest/howto/network_bgp/index.html.md#network-bgp)