The provided IP address range (%{range}) is not within the d

Error message

The provided IP address range (%{range}) is not within the
defined subnet (%{subnet}). Please provide an address range
within the defined subnet.

What it means

Error "The provided IP address range (%{range}) is not within the defined subnet (%{subnet}). Please provide an address range within the defined subnet." thrown in hashicorp/vagrant.

Source

Thrown at plugins/providers/docker/action/prepare_networks.rb:300

            prefix: false
          )
          range = nil
          while !range
            range = env[:ui].ask(I18n.t(
              "docker_provider.network_bridge_iprange_request",
              interface: interface.name,
              default_range: network_options[:subnet]) + " ",
              prefix: false
            ).strip
            if range.empty?
              range = network_options[:subnet]
            end
            begin
              range = IPAddr.new(range)
              if !subnet.include?(range)
                netmask = interface.netmask.ip_unpack.first
                prefix = IPAddr.new("255.255.255.255/#{netmask}").to_i.to_s(2).count("1")
                env[:ui].warn(I18n.t(
                  "docker_provider.network_bridge_iprange_outofbounds",
                  subnet: network_options[:subnet],
                  range: "#{range}/#{prefix}"
                ) + "\n", prefix: false)
                range = nil
              end
            rescue IPAddr::InvalidAddressError
              env[:ui].warn(I18n.t(
                "docker_provider.network_bridge_iprange_invalid",
                range: range) + "\n", prefix: false)
              range = nil
            end
          end

          netmask = interface.netmask.ip_unpack.first
          prefix = IPAddr.new("255.255.255.255/#{netmask}").to_i.to_s(2).count("1")
          "#{range}/#{prefix}"
        end

View on GitHub (pinned to 35f3160f4a)

When it happens

Trigger: Thrown at plugins/providers/docker/action/prepare_networks.rb:300 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/173d2aa3c6959f27. Report an issue: GitHub.