Networking Configuration

PiVirt networking is configured via declarative YAML blocks defining default bridges, interface mappings, 802.1Q VLAN tags, and VXLAN mesh tunnels.

Bridge Configuration

Basic Bridge

network:
  default_bridge: "virbr0"
  bridges:
    - name: "virbr0"
      type: "bridge"
      interface: "eth0"
      # Optional settings
      stp: true
      forward_delay: 0
      vlan_filtering: false

VLAN-Aware Bridge

network:
  bridges:
    - name: "vlan-bridge"
      type: "bridge"
      interface: "eth0"
      vlan_aware: true
      vlans:
        - id: 10
          name: "management"
        - id: 20
          name: "storage"
        - id: 30
          name: "vm-network"

VLAN Configuration

network:
  vlans:
    - name: "vlan10"
      bridge: "virbr0"
      vlan_id: 10
      # Optional settings
      tagged: true
      priority: 100

VXLAN Configuration

network:
  vxlans:
    - name: "vxlan100"
      vni: 100
      local_ip: "10.0.1.10"
      remote_ips:
        - "10.0.1.11"
        - "10.0.1.12"
      # Optional settings
      port: 4789
      ttl: 64
      learning: true

SR-IOV Configuration

network:
  sriov:
    - name: "sriov-net"
      pf: "eth2"
      vfs: 8
      # Optional settings
      vlan: 100
      qos: 10

Network Defaults

network:
  defaults:
    model: "virtio"
    queues: 2
    mtu: 1500

Environment Variables

PIVIRT_PIVIRTD_NETWORK_DEFAULT_BRIDGE="virbr0"
PIVIRT_PIVIRTD_NETWORK_DEFAULTS_MODEL="virtio"