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 bundler.io 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 61.2 MB
Stars 4,728
Forks 2,103
Watchers 176
Open issues 222
Dependencies 0
Contributors 626
Tags 284
Last updated
Last pushed

Top Contributors See all

André Arko Samuel Giddins The Bundler Bot David Rodríguez Homu Terence Lee José Valim Asutosh Palai SHIBATA Hiroshi Colby Swandale 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.0.pre.3 - Updated - 4.73K stars
You do not want to install it.
Latest release 2.0.13 - Updated - 4.73K stars

Recent Tags See all

v2.1.0.pre.3 November 12, 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.0.1 January 04, 2019
v2.0.0 January 03, 2019
v2.0.0.pre.3 December 30, 2018
v1.17.3 December 27, 2018
v1.17.2 December 11, 2018
v2.0.0.pre.2 November 27, 2018
v2.0.0.pre.1 November 09, 2018
v1.17.1 October 25, 2018
v1.17.0 October 25, 2018
v1.17.0.pre.2 October 13, 2018

Interesting Forks See all

Manage your application's gem dependencies with less pain
Ruby - MIT - Last pushed - 9 stars - 1 forks
Manage your application's gem dependencies with less pain
Ruby - MIT - Last pushed - 3 stars
Manage your application's gem dependencies with less pain
Ruby - MIT - Last pushed - 2 stars
Manage your application's gem dependencies with less pain
Ruby - MIT - Last pushed - 2 stars
Manage your application's gem dependencies with less pain
Ruby - MIT - Last pushed - 2 stars - 1 forks

Something wrong with this page? Make a suggestion

Last synced: 2019-11-12 18:40:48 UTC

Login to resync this repository