{"record":{"id":"aa6282c4ed2c8c5b","repo":"hashicorp/vagrant","slug":"no-nfs-client-was-detected-as-installed-in-your-gu","errorCode":null,"errorMessage":"No NFS client was detected as installed in your guest machine. This\nis required for NFS synced folders to work. In addition to this, Vagrant\ndoesn't know how to automatically install NFS for your machine, so\nyou must do this manually.","messagePattern":"No NFS client was detected as installed in your guest machine\\. This\nis required for NFS synced folders to work\\. In addition to this, Vagrant\ndoesn't know how to automatically install NFS for your machine, so\nyou must do this manually\\.","errorType":"exception","errorClass":"Vagrant::Errors::NFSClientNotInstalledInGuest","httpStatus":null,"severity":"error","filePath":"plugins/synced_folders/nfs/synced_folder.rb","lineNumber":56,"sourceCode":"        end\n        return false if !raise_error\n        raise Vagrant::Errors::NFSNotSupported\n      end\n\n      def prepare(machine, folders, opts)\n        # Nothing is necessary to do before VM boot.\n      end\n\n      def enable(machine, folders, nfsopts)\n        raise Vagrant::Errors::NFSNoHostIP if !nfsopts[:nfs_host_ip]\n        raise Vagrant::Errors::NFSNoGuestIP if !nfsopts[:nfs_machine_ip]\n\n        if machine.config.nfs.verify_installed\n          if machine.guest.capability?(:nfs_client_installed)\n            installed = machine.guest.capability(:nfs_client_installed)\n            if !installed\n              can_install = machine.guest.capability?(:nfs_client_install)\n              raise Vagrant::Errors::NFSClientNotInstalledInGuest if !can_install\n              machine.ui.info I18n.t(\"vagrant.actions.vm.nfs.installing\")\n              machine.guest.capability(:nfs_client_install)\n            end\n          end\n        end\n\n        machine_ip = nfsopts[:nfs_machine_ip]\n        machine_ip = [machine_ip] if !machine_ip.is_a?(Array)\n\n        # Prepare the folder, this means setting up various options\n        # and such on the folder itself.\n        folders.each { |id, opts| prepare_folder(machine, opts) }\n\n        # Determine what folders we'll export\n        export_folders = folders.dup\n        export_folders.keys.each do |id|\n          opts = export_folders[id]\n          if opts.key?(:nfs_export) && !opts[:nfs_export]","sourceCodeStart":38,"sourceCodeEnd":74,"githubUrl":"https://github.com/hashicorp/vagrant/blob/35f3160f4ad6edc3a9f3aa9570adfc1a4d73aaa5/plugins/synced_folders/nfs/synced_folder.rb#L38-L74","documentation":"With config.nfs.verify_installed (default true), enable asks the guest's nfs_client_installed capability whether an NFS client exists. If not installed and the guest also lacks an nfs_client_install capability, Vagrant raises NFSClientNotInstalledInGuest: the missing prerequisite was detected and Vagrant cannot auto-install it for that guest OS.","triggerScenarios":"Booting a guest whose distro has the nfs_client_installed capability but no nfs_client_install capability, without nfs-common/nfs-utils preinstalled, while mounting type: \"nfs\" synced folders.","commonSituations":"Minimal/custom bboxes with packages stripped; less common distros where Vagrant only detects, not installs; containers-as-VMs images.","solutions":["Install the NFS client in the guest manually (apt-get install nfs-common / yum install nfs-utils) and bake it into the box image","Add it via Packer/box build so future boots pass verification","Switch the folder type to virtualbox/rsync if the guest never needs NFS","Set config.nfs.verify_installed = false only if you are certain the client exists"],"exampleFix":"# before\nconfig.vm.synced_folder \".\", \"/vagrant\", type: \"nfs\"  # guest lacks nfs client\n\n# after\nconfig.vm.provision \"shell\", inline: \"apt-get update && apt-get install -y nfs-common\"\nconfig.vm.synced_folder \".\", \"/vagrant\", type: \"nfs\"  # requires reload after install","handlingStrategy":"validation","validationCode":"# Vagrantfile: install the client before NFS mounts matter\nconfig.vm.provision \"shell\", inline: \"apt-get install -y nfs-common || yum install -y nfs-utils\"","typeGuard":"def nfs_client_installable?(machine)\n  machine.guest.capability?(:nfs_client_install)\nend","tryCatchPattern":"begin\n  env.cli(%w(up))\nrescue Vagrant::Errors::NFSClientNotInstalledInGuest\n  abort \"Bake nfs-common/nfs-utils into the box, then vagrant reload\"\nend","preventionTips":["Include the NFS client in Packer box builds","Use nfs/virtualbox/rsync folder types matching what the guest image supports","Avoid verify_installed=false unless you know the client exists"],"tags":["nfs","synced-folders","guest","missing-package"],"backgroundTag":"guest-package-not-installed","analyzedSha":"35f3160f4ad6edc3a9f3aa9570adfc1a4d73aaa5","analyzedAt":"2026-08-21T13:34:32.514Z","schemaVersion":2},"datasetVersion":"2026-08-21T18:17:14.833Z"}