{"record":{"id":"e6ddf179f48e9cb4","repo":"hashicorp/vagrant","slug":"the-box-name-does-not-exist-please-double-ch","errorCode":null,"errorMessage":"The box '%{name}' does not exist. Please double check and\ntry again. You can see the boxes that are installed with\n`vagrant box list`.","messagePattern":"The box '%(.+?)' does not exist\\. Please double check and\ntry again\\. You can see the boxes that are installed with\n`vagrant box list`\\.","errorType":"exception","errorClass":"Vagrant::Errors::BoxNotFound","httpStatus":null,"severity":"error","filePath":"plugins/commands/box/command/update.rb","lineNumber":72,"sourceCode":"            update_specific(options[:box], options[:provider], options[:architecture], download_options, options[:force])\n          else\n            update_vms(argv, options[:provider], download_options, options[:force])\n          end\n\n          0\n        end\n\n        def update_specific(name, provider, architecture, download_options, force)\n          box_info = Vagrant::Util::HashWithIndifferentAccess.new\n          @env.boxes.all.each do |box_name, box_version, box_provider, box_architecture|\n            next if name != box_name\n            box_info[box_provider] ||= Vagrant::Util::HashWithIndifferentAccess.new\n            box_info[box_provider][box_version] ||= []\n            box_info[box_provider][box_version].push(box_architecture.to_s).uniq!\n          end\n\n          if box_info.empty?\n            raise Vagrant::Errors::BoxNotFound, name: name.to_s\n          end\n\n          if !provider\n            if box_info.size > 1\n              raise Vagrant::Errors::BoxUpdateMultiProvider,\n                name: name.to_s,\n                providers: box_info.keys.map(&:to_s).sort.join(\", \")\n            end\n\n            provider = box_info.keys.first\n          elsif !box_info[provider]\n            raise Vagrant::Errors::BoxNotFoundWithProvider,\n              name: name.to_s,\n              provider: provider.to_s,\n              providers: box_info.keys.map(&:to_s).sort.join(\", \")\n          end\n\n          version = box_info[provider].keys.sort_by{ |v| Gem::Version.new(v) }.last","sourceCodeStart":54,"sourceCodeEnd":90,"githubUrl":"https://github.com/hashicorp/vagrant/blob/35f3160f4ad6edc3a9f3aa9570adfc1a4d73aaa5/plugins/commands/box/command/update.rb#L54-L90","documentation":"Raised by `vagrant box update --box <name>` (update_specific) when a scan over all installed boxes finds none whose name equals the requested one, leaving the box_info hash empty. The filter is `next if name != box_name` - exact string equality against the stored box name - so casing or slug differences (owner/name) count as not found.","triggerScenarios":"`vagrant box update --box ubuntu/jammy` when the box is installed under a different name or not installed at all; passing a display name instead of the stored slug.","commonSituations":"Box never added on this machine; wrong owner prefix; assuming `--box` accepts a URL or a partial name.","solutions":["Run `vagrant box list` and copy the exact stored name","If missing, install it first: `vagrant box add <name>`","Then retry `vagrant box update --box <exact-name>`"],"exampleFix":"# before\nvagrant box update --box ubuntu\n# error: box 'ubuntu' does not exist\n\n# after\nvagrant box list            # shows ubuntu/jammy\nvagrant box add ubuntu/jammy # if not listed\nvagrant box update --box ubuntu/jammy","handlingStrategy":"validation","validationCode":"# bash: verify the box name exists before updating\nvagrant box list | awk '{print $1}' | sort -u | grep -qx \"$BOX\" ||\n  { echo \"box not installed: $BOX\"; vagrant box add \"$BOX\"; }","typeGuard":"# Ruby: exact-name check against the installed collection\ndef box_name_installed?(env, name)\n  env.boxes.all.any? { |box_name, *_| box_name == name }\nend","tryCatchPattern":null,"preventionTips":["Use the full slug (owner/name) exactly as shown by `vagrant box list`","Gate update scripts on the box existing; auto-add when missing","Watch for casing differences - matching is exact string equality"],"tags":["box","update","not-found"],"backgroundTag":"resource-not-found","analyzedSha":"35f3160f4ad6edc3a9f3aa9570adfc1a4d73aaa5","analyzedAt":"2026-08-21T13:34:32.514Z","schemaVersion":2},"datasetVersion":"2026-08-21T18:17:14.833Z"}