{"record":{"id":"07746b93da6c9218","repo":"hashicorp/vagrant","slug":"the-checksum-of-the-downloaded-provider-provide-07746b","errorCode":null,"errorMessage":"The checksum of the downloaded provider '%{provider}' did not match the\nexpected value. If the problem persists, please install the provider\nmanually.\n\nExpected: %{expected}\nReceived: %{actual}","messagePattern":"The checksum of the downloaded provider '%(.+?)' did not match the\nexpected value\\. If the problem persists, please install the provider\nmanually\\.\n\nExpected: %(.+?)\nReceived: %(.+?)","errorType":"exception","errorClass":"Vagrant::Errors::ProviderChecksumMismatch","httpStatus":null,"severity":"error","filePath":"plugins/hosts/windows/cap/provider_install_virtualbox.rb","lineNumber":40,"sourceCode":"        def self.provider_install_virtualbox(env)\n          path = Dir::Tmpname.create(\"vagrant-provider-install-virtualbox\") {}\n\n          # Prefixed UI for prettiness\n          ui = Vagrant::UI::Prefixed.new(env.ui, \"\")\n\n          # Start by downloading the file using the standard mechanism\n          ui.output(I18n.t(\n            \"vagrant.hosts.windows.virtualbox_install_download\",\n            version: VERSION))\n          ui.detail(I18n.t(\n            \"vagrant.hosts.windows.virtualbox_install_detail\"))\n          dl = Vagrant::Util::Downloader.new(URL, path, ui: ui)\n          dl.download!\n\n          # Validate that the file checksum matches\n          actual = FileChecksum.new(path, Digest::SHA2).checksum\n          if actual != SHA256SUM\n            raise Vagrant::Errors::ProviderChecksumMismatch,\n              provider: \"virtualbox\",\n              actual: actual,\n              expected: SHA256SUM\n          end\n\n          # Launch it\n          ui.output(I18n.t(\n            \"vagrant.hosts.windows.virtualbox_install_install\"))\n          ui.detail(I18n.t(\n            \"vagrant.hosts.windows.virtualbox_install_install_detail\"))\n          script = File.expand_path(\"../../scripts/install_virtualbox.ps1\", __FILE__)\n          result = Vagrant::Util::PowerShell.execute(script, path)\n          if result.exit_code != 0\n            raise Vagrant::Errors::ProviderInstallFailed,\n              provider: \"virtualbox\",\n              stdout: result.stdout,\n              stderr: result.stderr\n          end","sourceCodeStart":22,"sourceCodeEnd":58,"githubUrl":"https://github.com/hashicorp/vagrant/blob/35f3160f4ad6edc3a9f3aa9570adfc1a4d73aaa5/plugins/hosts/windows/cap/provider_install_virtualbox.rb#L22-L58","documentation":"Windows twin of the macOS checksum guard: plugins/hosts/windows/cap/provider_install_virtualbox.rb:40 raises Vagrant::Errors::ProviderChecksumMismatch after `Vagrant::Util::Downloader` fetches the VirtualBox installer and `FileChecksum.new(path, Digest::SHA2).checksum` does not equal the pinned SHA256SUM. The package is never executed on mismatch.","triggerScenarios":"`vagrant up` on Windows with VirtualBox absent triggers auto-install; the download completes but hashes differently — proxy/AV content rewriting, truncated transfer, or the upstream artifact at the URL differing from what this Vagrant release pinned.","commonSituations":"Corporate proxies injecting block pages; Defender/AV altering downloads; unstable links truncating large files; stale pinned checksums after VirtualBox re-releases under the same URL.","solutions":["Retry the download (re-run `vagrant up`) with stable connectivity","Install VirtualBox manually from virtualbox.org so auto-install is skipped","Update Vagrant so the pinned checksum matches the published artifact","Verify manually: `Get-FileHash -Algorithm SHA256 <file>` and compare to the error's Expected value; fix proxy/AV if they differ"],"exampleFix":null,"handlingStrategy":"retry","validationCode":null,"typeGuard":null,"tryCatchPattern":"attempts = 0\nbegin\n  provider_install.call\nrescue Vagrant::Errors::ProviderChecksumMismatch => e\n  attempts += 1\n  warn \"checksum mismatch (expected #{e.data[:expected]}, got #{e.data[:actual]})\"\n  retry if attempts < 2\n  raise # then instruct manual install / proxy investigation\nend","preventionTips":["Pre-install VirtualBox in Windows CI images","Verify proxy/AV are not rewriting downloads (`Get-FileHash` before executing anything)","Update Vagrant when updating VirtualBox"],"tags":["virtualbox","provider-install","checksum","windows","download"],"backgroundTag":"checksum-verification-failed","analyzedSha":"35f3160f4ad6edc3a9f3aa9570adfc1a4d73aaa5","analyzedAt":"2026-08-21T13:34:32.514Z","schemaVersion":2},"datasetVersion":"2026-08-21T18:17:14.833Z"}