ruby/rubygems · error · Gem::RuntimeRequirementNotMetError

#{spec.full_name} requires Ruby version #{rrv}. The current

Error message

#{spec.full_name} requires Ruby version #{rrv}. The current ruby version is #{ruby_version}.

What it means

Error "#{spec.full_name} requires Ruby version #{rrv}. The current ruby version is #{ruby_version}." thrown in ruby/rubygems.

Source

Thrown at lib/rubygems/resolver/installer_set.rb:255

    when :remote then
      @domain = nil unless remote
    when :both then
      @domain = :local unless remote
    end
  end

  private

  def metadata_satisfied?(spec)
    spec.required_ruby_version.satisfied_by?(Gem.ruby_version) &&
      spec.required_rubygems_version.satisfied_by?(Gem.rubygems_version)
  end

  def ensure_required_ruby_version_met(spec) # :nodoc:
    if rrv = spec.required_ruby_version
      ruby_version = Gem.ruby_version
      unless rrv.satisfied_by? ruby_version
        raise Gem::RuntimeRequirementNotMetError,
          "#{spec.full_name} requires Ruby version #{rrv}. The current ruby version is #{ruby_version}."
      end
    end
  end

  def ensure_required_rubygems_version_met(spec) # :nodoc:
    if rrgv = spec.required_rubygems_version
      unless rrgv.satisfied_by? Gem.rubygems_version
        rg_version = Gem::VERSION
        raise Gem::RuntimeRequirementNotMetError,
          "#{spec.full_name} requires RubyGems version #{rrgv}. The current RubyGems version is #{rg_version}. " \
          "Try 'gem update --system' to update RubyGems itself."
      end
    end
  end
end

View on GitHub (pinned to 86cbb817a3)

Solutions

1. Use a Ruby version matching the gem's required_ruby_version
2. Or install an older version of the gem compatible with your Ruby

When it happens

Trigger: Thrown at lib/rubygems/resolver/installer_set.rb:255 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of ruby/rubygems@86cbb817a3 (2026-08-23). Data as JSON: /api/errors/0ad67171d71fd61b. Report an issue: GitHub.