Manage your Ruby application's gem dependencies

License: MIT

Language: Ruby

Keywords: dependency-manager, ruby, rubygems

Version     Build Status Inline docs Slack

Bundler: a gem to bundle gems

Bundler makes sure Ruby applications run the same code on every machine.

It does this by managing the gems that the application depends on. Given a list of gems, it can automatically download and install those gems, as well as any other gems needed by the gems that are listed. Before installing gems, it checks the versions of every gem to make sure that they are compatible, and can all be loaded at the same time. After the gems have been installed, Bundler can help you update some or all of them when new versions become available. Finally, it records the exact versions that have been installed, so that others can install the exact same gems.

Installation and usage

To install (or update to the latest version):

gem install bundler

To install a prerelease version (if one is available), run gem install bundler --pre. To uninstall Bundler, run gem uninstall bundler.

Bundler is most commonly used to manage your application's dependencies. For example, these commands will allow you to use Bundler to manage the rspec gem for your application:

bundle init
bundle add rspec
bundle install
bundle exec rspec

See for the full documentation.


For help with common problems, see TROUBLESHOOTING.

Still stuck? Try filing an issue.

Other questions

To see what has changed in recent versions of Bundler, see the CHANGELOG.

To get in touch with the Bundler core team and other Bundler users, please see getting help.


If you'd like to contribute to Bundler, that's awesome, and we <3 you. We've put together the Bundler contributor guide with all of the information you need to get started.

If you'd like to request a substantial change to Bundler or to the Bundler documentation, refer to the Bundler RFC process for more information.

While some Bundler contributors are compensated by Ruby Together, the project maintainers make decisions independent of Ruby Together. As a project, we welcome contributions regardless of the author's affiliation with Ruby Together.


Ruby Together pays some Bundler maintainers for their ongoing work. As a grassroots initiative committed to supporting the critical Ruby infrastructure you rely on, Ruby Together is funded entirely by the Ruby community. Contribute today as an individual or (better yet) as a company to ensure that Bundler, RubyGems, and other shared tooling is around for years to come.

Code of Conduct

Everyone interacting in the Bundler project's codebases, issue trackers, chat rooms, and mailing lists is expected to follow the Bundler code of conduct.


Bundler is available under an MIT License.

Project Statistics

Sourcerank 26
Repository Size 216 MB
Stars 4,782
Forks 2,124
Watchers 172
Open issues 233
Dependencies 0
Contributors 628
Tags 297
Last updated
Last pushed

Top Contributors See all

André Arko Samuel Giddins The Bundler Bot David Rodríguez Homu Terence Lee José Valim Colby Swandale SHIBATA Hiroshi Asutosh Palai Yehuda Katz James Wen Smit Shah Tim Moore Natalie Weizenbaum Agrim Mittal Erik Berlin Joshua Hull boggs ⚓ chrismo

Packages Referencing this Repo

Bundler manages an application's dependencies through its entire life, across many machines, syst...
Latest release 2.1.4 - Updated - 4.78K stars
You do not want to install it.
Latest release 2.0.13 - Updated - 4.78K stars

Recent Tags See all

v2.1.4 January 05, 2020
v2.1.3 January 02, 2020
v2.1.2 December 20, 2019
v2.1.1 December 17, 2019
v2.1.0 December 14, 2019
v2_7_0_preview3 November 22, 2019
v2.1.0.pre.3 November 12, 2019
v2_7_0_preview2 October 22, 2019
v2.1.0.pre.2 September 15, 2019
v September 15, 2019
v2.1.0.pre.1 August 28, 2019
v2.0.2 June 13, 2019
v2_7_0_preview1 May 30, 2019
v2.0.1 January 04, 2019
v2.0.0 January 03, 2019

Something wrong with this page? Make a suggestion

Last synced: 2019-12-15 15:31:25 UTC

Login to resync this repository