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

A Vagrant environment or target machine is required to run t

Error message

A Vagrant environment or target machine is required to run this
command. Run `vagrant init` to create a new Vagrant environment. Or,
get an ID of a target machine from `vagrant global-status` to run this
command on. A final option is to change to a directory with a
Vagrantfile and to try again.

What it means

A v1 plugin command tried to operate on VMs through with_target_vms but the environment has no root project (env.root_path is nil), i.e. the current directory (or VAGRANT_CWD) is not inside a Vagrant project (lib/vagrant/plugin/v1/command.rb:70). V1 commands predate `vagrant global-status` machine IDs, so they have no target to fall back on. The fix is to run the command where a Vagrantfile exists.

Source

Thrown at lib/vagrant/plugin/v1/command.rb:70

          opts.parse!(argv)
          return argv
        rescue OptionParser::InvalidOption
          raise Errors::CLIInvalidOptions, help: opts.help.chomp
        end

        # Yields a VM for each target VM for the command.
        #
        # This is a convenience method for easily implementing methods that
        # take a target VM (in the case of multi-VM) or every VM if no
        # specific VM name is specified.
        #
        # @param [String] name The name of the VM. Nil if every VM.
        # @param [Boolean] single_target If true, then an exception will be
        #   raised if more than one target is found.
        def with_target_vms(names=nil, options=nil)
          # Using VMs requires a Vagrant environment to be properly setup
          raise Errors::NoEnvironmentError if !@env.root_path

          # Setup the options hash
          options ||= {}

          # Require that names be an array
          names ||= []
          names = [names] if !names.is_a?(Array)

          # First determine the proper array of VMs.
          vms = []
          if names.length > 0
            names.each do |name|
              if pattern = name[/^\/(.+?)\/$/, 1]
                # This is a regular expression name, so we convert to a regular
                # expression and allow that sort of matching.
                regex = Regexp.new(pattern)

                @env.vms.each do |name, vm|

View on GitHub (pinned to 35f3160f4a)

Solutions

1. cd into the directory containing the Vagrantfile and re-run the command
2. Run `vagrant init` there first if you intended to create a new environment
3. Unset a stale VAGRANT_CWD (`unset VAGRANT_CWD`) or point it at the real project
4. Prefer the equivalent built-in v2 command, which also accepts machine IDs from `vagrant global-status`

env = Vagrant::Environment.new
abort "run this inside a Vagrant project (directory with a Vagrantfile)" unless env.root_path

begin
  command.with_target_vms { |vm| operate(vm) }
rescue Vagrant::Errors::NoEnvironmentError
  warn "cd into a directory with a Vagrantfile or run `vagrant init` first"
end

When it happens

Trigger: Executing a v1-era plugin command in a directory with no Vagrantfile in it or any parent; or with VAGRANT_CWD pointing at a non-project directory — with_target_vms raises immediately before yielding any VM.

Common situations: Running from the home directory or a scripts folder; wrong tmux pane; a stale VAGRANT_CWD env var left over from another project.

Related errors

• A Vagrant environment or target machine is required to run t
• An invalid option was specified. The help for this command i
• No virtual machines matched the regular expression given.
• A VM by the name of %{name} was not found.
• This command requires a specific VM name to target in a mult

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