bundle man page

bundle — Ruby Dependency Management


bundle install

bundle update

bundle update --source gemname

bundle gem gemname


bundle COMMAND [--no-color] [--verbose] [ARGS]


Bundler manages an application´s dependencies through its entire life across many machines systematically and repeatably.

See the bundler website http://bundler.io for information on getting started, and Gemfile(5) for more information on the Gemfile format.



Print all output without color

--retry, -r

Specify the number of times you wish to attempt network commands

--verbose, -V

Print out additional logging information

Bundle Commands

We divide bundle subcommands into primary commands and utilities.

Primary Commands

[bundle install(1)][bundle-install]

Install the gems specified by the Gemfile or Gemfile.lock

[bundle update(1)][bundle-update]

Update dependencies to their latest versions

[bundle package(1)][bundle-package]

Package the .gem files required by your application into the vendor/cache directory

[bundle exec(1)][bundle-exec]

Execute a script in the context of the current bundle

[bundle config(1)][bundle-config]

Specify and read configuration options for bundler

bundle help(1)

Display detailed help for each subcommand


bundle add(1)

Add the named gem to the Gemfile and run bundle install

bundle binstubs(1)

Generate binstubs for executables in a gem

bundle check(1)

Determine whether the requirements for your application are installed and available to bundler

bundle show(1)

Show the source location of a particular gem in the bundle

[bundle outdated(1)][bundle-outdated]

Show all of the outdated gems in the current bundle

bundle console(1)

Start an IRB session in the context of the current bundle

bundle open(1)

Open an installed gem in the editor

[bundle lock(1)][bundle-lock]

Generate a lockfile for your dependencies

bundle viz(1)

Generate a visual representation of your dependencies

bundle init(1)

Generate a simple Gemfile, placed in the current directory

[bundle gem(1)][bundle-gem]

Create a simple gem, suitable for development with bundler

[bundle platform(1)][bundle-platform]

Display platform compatibility information

bundle clean(1)

Clean up unused gems in your bundler directory

bundle doctor(1)

Display warnings about common potential problems


When running a command that isn´t listed in Primary Commands or Utilities, Bundler will try to find an executable on your path named bundler-<command> and execute it, passing down any extra arguments to it.


These commands are obsolete and should no longer be used


July 2017