BUNDLE-ADD(1) General Commands Manual BUNDLE-ADD(1)

# [NAME](#NAME)

**bundle-add** - Add gem to the Gemfile and run bundle install

# [SYNOPSIS](#SYNOPSIS)

**bundle add** *GEM\_NAME* \[--group=GROUP] \[--version=VERSION] \[--source=SOURCE] \[--path=PATH] \[--git=GIT|--github=GITHUB] \[--branch=BRANCH] \[--ref=REF] \[--cooldown=NUMBER] \[--quiet] \[--skip-install] \[--strict|--optimistic]

# [DESCRIPTION](#DESCRIPTION)

Adds the named gem to the \[[**Gemfile(5)**](/man/os/ruby3.4-bundler/Gemfile.5)]\[[Gemfile(5)](/man/os/ruby3.4-bundler/Gemfile.5)] and run **bundle install**. **bundle install** can be avoided by using the flag **--skip-install**.

# [OPTIONS](#OPTIONS)

[**--version=VERSION**, **-v=VERSION**](#version=VERSION)

Specify version requirements(s) for the added gem.

[**--group=GROUP**, **-g=GROUP**](#group=GROUP)

Specify the group(s) for the added gem. Multiple groups should be separated by commas.

[**--source=SOURCE**, **-s=SOURCE**](#source=SOURCE)

Specify the source for the added gem.

[**--require=REQUIRE**, **-r=REQUIRE**](#require=REQUIRE)

Adds require path to gem. Provide false, or a path as a string.

[**--path=PATH**](#path=PATH)

Specify the file system path for the added gem.

[**--git=GIT**](#git=GIT)

Specify the git source for the added gem.

[**--github=GITHUB**](#github=GITHUB)

Specify the github source for the added gem.

[**--branch=BRANCH**](#branch=BRANCH)

Specify the git branch for the added gem.

[**--ref=REF**](#ref=REF)

Specify the git ref for the added gem.

[**--glob=GLOB**](#glob=GLOB)

Specify the location of a dependency's .gemspec, expanded within Ruby (single quotes recommended).

[**--quiet**](#quiet)

Do not print progress information to the standard output.

[**--skip-install**](#skip)

Adds the gem to the Gemfile but does not install it.

[**--optimistic**](#optimistic)

Adds optimistic declaration of version.

[**--strict**](#strict)

Adds strict declaration of version.

[**--cooldown=<number>**](#cooldown=_number_)

Only consider gem versions published at least *number* days ago when resolving. Pass **0** to disable cooldown for this run. See **cooldown** in [bundle-config(1)](/man/os/ruby3.4-bundler/bundle-config.1) for precedence rules.

# [EXAMPLES](#EXAMPLES)

1\.

You can add the **rails** gem to the Gemfile without any version restriction. The source of the gem will be the global source.

**bundle add rails**

2\.

You can add the **rails** gem with version greater than 1.1 (not including 1.1) and less than 3.0.

**bundle add rails --version "> 1.1, < 3.0"**

3\.

You can use the **https://gems.example.com** custom source and assign the gem to a group.

**bundle add rails --version "~> 5.0.0" --source "https://gems.example.com" --group "development"**

4\.

The following adds the **gem** entry to the Gemfile without installing the gem. You can install gems later via **bundle install**.

**bundle add rails --skip-install**

5\.

You can assign the gem to more than one group.

**bundle add rails --group "development, test"**

# [SEE ALSO](#SEE_ALSO)

[Gemfile(5)](/man/os/ruby3.4-bundler/Gemfile.5) *https://bundler.io/man/gemfile.5.html*, [bundle-remove(1)](/man/os/ruby3.4-bundler/bundle-remove.1) *bundle-remove.1.html*

April 2026

---

Document: bundle-add(1) from ruby3.4-bundler 4.0.17-r0 (Chainguard OS)
Source: https://github.com/rubygems/rubygems