hashicorp/vagrant · error · Vagrant::Errors::CantReadMACAddresses

The provider you are using ('%{provider}') doesn't support

Error message

The provider you are using  ('%{provider}') doesn't support the
"nic_mac_addresses" provider capability which is required
for advanced networking to work with this guest OS. Please inform
the author of the provider to add this feature.

Until then, you must remove any networking configurations other
than forwarded ports from your Vagrantfile for Vagrant to continue.

What it means

Error "The provider you are using ('%{provider}') doesn't support the "nic_mac_addresses" provider capability which is required for advanced networking to work with this guest OS. Please inform the author of the provider to add this feature. Until then, you must remove any networking configurations other than forwarded ports from your Vagrantfile for Vagrant to continue." thrown in hashicorp/vagrant.

Source

Thrown at plugins/guests/darwin/cap/configure_networks.rb:18

# Copyright IBM Corp. 2010, 2025
# SPDX-License-Identifier: BUSL-1.1

require "tempfile"

require "vagrant/util/template_renderer"

module VagrantPlugins
  module GuestDarwin
    module Cap
      class ConfigureNetworks
        @@logger = Log4r::Logger.new("vagrant::guest::darwin::configure_networks")

        include Vagrant::Util

        def self.configure_networks(machine, networks)
          if !machine.provider.capability?(:nic_mac_addresses)
            raise Vagrant::Errors::CantReadMACAddresses,
                  provider: machine.provider_name.to_s
          end

          nic_mac_addresses = machine.provider.capability(:nic_mac_addresses)
          @@logger.debug("mac addresses: #{nic_mac_addresses.inspect}")

          mac_service_map = create_mac_service_map(machine)

          networks.each do |network|
            mac_address = nic_mac_addresses[network[:interface]+1]
            if mac_address.nil?
              @@logger.warn("Could not find mac address for network #{network.inspect}")
              next
            end

            service_name = mac_service_map[mac_address]
            if service_name.nil?
              @@logger.warn("Could not find network service for mac address #{mac_address}")

View on GitHub (pinned to 35f3160f4a)

When it happens

Trigger: Thrown at plugins/guests/darwin/cap/configure_networks.rb:18 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of hashicorp/vagrant@35f3160f4a (2026-08-21). Data as JSON: /api/errors/43ae9f20591162a7. Report an issue: GitHub.