Skip to content

Multi-homed VMs


This feature is available with bosh-openstack-cpi v24+.


This feature requires OpenStack Neutron.

Limitation: This feature requires DHCP to be disabled

Disabling DHCP means that the network devices on your VMs will not get configuration such as default gateway, DNS, and MTU. If you require specific values for these settings, you will need to set them by other means.

  1. In your Director deployment manifest, set [properties.openstack.use_dhcp: false] ( This means the BOSH agent will configure the network devices without DHCP. This is a Director-wide setting and switches off DHCP for all VMs deployed with this Director.
  2. In your Director deployment manifest, set [properties.openstack.config_drive: cdrom] ( This means OpenStack will mount a cdrom drive to distribute meta-data and user-data instead of using an HTTP metadata service.
  3. In your BOSH network configuration, set gateway and dns to allow outbound communication.
  4. If you're not using VLAN, but a tunnel mechanism for Neutron networking, you also need to set the MTU for your network devices on all VMs:

    • GRE Tunnels incur an overhead of 42 bytes, therefore set your MTU to 1458
    • VXLAN Tunnels incur an overhead of 50 bytes, therefore set your MTU to 1450


    The above numbers assume that you're using an MTU of 1500 for the physical network. If your physical network is setup differently, adapt the MTU values accordingly.

Setting the MTU for network devices is currently not possible in the deployment manifest's networks section and thus requires manual user interaction. We recommend to co-locate the networking-release's set_mtu job using addons.