Guides
Getting Started
Guides
Dependency Management
- How to manage application dependencies with Bundler
- How to manage dependencies with Bundler
- How to update gems with Bundler
- How to manage groups of gems
- How to install gems from git repositories
- Recommended Workflow with Version Control
- How to use Bundler with Ruby
- How to use Bundler in a single-file Ruby script
- How to deploy bundled applications
Gem Development
Publishing & Security
- Trusted Publishing
- Setting up multi-factor authentication
- Using multi-factor authentication in command line
- MFA requirement opt in
- Managing owners using UI
- Organizations
- Removing a Published gem
- Security Practices
Integrations
- How to use Bundler with Rails
- How to use Bundler with Sinatra
- How to use Bundler with Docker
- How to use Bundler with RubyMotion
Hosting & Sources
Extending
Troubleshooting
- How to troubleshoot RubyGems and Bundler TLS/SSL Issues
- SSL Certificate Update
- How to use git bisect with Bundler
Concepts
Reference
- gem Command Reference
- Bundler Command Reference
- Gemfile Reference
- Ruby Directive
- Specification Reference
- RubyGems.org API
- RubyGems.org API V2.0
- RubyGems.org Compact Index API
- RubyGems.org rate limits
- API key scopes
- Bundler compatibility with Ruby
- Known Bundler Plugins
Appendix
Bundler compatibility with Ruby
Bundler compatibility with Ruby & RubyGems
The latest Bundler release should always support, at the very least, all rubies that have not yet reached their End of Life date.
The latest Bundler release should always support all RubyGems versions higher than or equal to the one shipped with the oldest Ruby version supported. RubyGems is not allowed to be downgraded further than that, so upgrading or downgrading RubyGems should not affect Bundler.
That effectively comes down to the following:
- Bundler 4.0 or higher
- requires a minimum ruby version of 3.2.0, and a minimum RubyGems version of 3.4.1 (version of RubyGems shipped with ruby 3.2.0).
- Bundler 2.7
- requires a minimum ruby version of 3.2.0, and a minimum RubyGems version of 3.4.1 (version of RubyGems shipped with ruby 3.2.0).
- Bundler 2.6
- requires a minimum ruby version of 3.1.0, and a minimum RubyGems version of 3.3.3 (version of RubyGems shipped with ruby 3.1.0).
- Bundler 2.5
- requires a minimum ruby version of 3.0.0, and a minimum RubyGems version of 3.2.3 (version of RubyGems shipped with ruby 3.0.0).
- Bundler 2.4
- requires a minimum ruby version of 2.6.0, and a minimum RubyGems version of 3.0.1 (version of RubyGems shipped with ruby 2.6.0).
- Bundler 2.0 through 2.3
- requires a minimum ruby version of 2.3.0, and a minimum RubyGems version of 2.5 (version of RubyGems shipped with ruby 2.3.0).
- Bundler 1
- requires a minimum Ruby version of 1.8.7, and a minimum RubyGems version of 1.3.6 (version of RubyGems shipped with ruby 1.8.7).