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

The plugin you're attempting to uninstall ('%{name}') is a s

Error message

The plugin you're attempting to uninstall ('%{name}') is a
system plugin. This means that the plugin is part of the installation
of Vagrant. These plugins cannot be removed.

You can however, install a plugin with the same name to replace
these plugins. User-installed plugins take priority over
system-installed plugins.

What it means

Error "The plugin you're attempting to uninstall ('%{name}') is a system plugin. This means that the plugin is part of the installation of Vagrant. These plugins cannot be removed. You can however, install a plugin with the same name to replace these plugins. User-installed plugins take priority over system-installed plugins." thrown in hashicorp/vagrant.

Source

Thrown at lib/vagrant/plugin/manager.rb:213

            raise Errors::BundlerError, message: err.message
          end
          raise Errors::PluginMissingLibrary,
            library: lib.captures.first,
            name: name
        when /find header files for ruby/
          raise Errors::PluginMissingRubyDev
        else
          raise Errors::BundlerError, message: err.message
        end
      end

      # Uninstalls the plugin with the given name.
      #
      # @param [String] name
      def uninstall_plugin(name, **opts)
        if @system_file
          if !@user_file.has_plugin?(name) && @system_file.has_plugin?(name)
            raise Errors::PluginUninstallSystem,
              name: name
          end
        end

        if opts[:env_local] && @local_file.nil?
          raise Errors::PluginNoLocalError
        end

        plugin_file = opts[:env_local] ? @local_file : @user_file

        if !plugin_file.has_plugin?(name)
          raise Errors::PluginNotInstalled,
            name: name
        end

        plugin_file.remove_plugin(name)

        # Clean the environment, removing any old plugins

View on GitHub (pinned to 35f3160f4a)

When it happens

Trigger: Thrown at lib/vagrant/plugin/manager.rb:213 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/b8f3f857402adac1. Report an issue: GitHub.