---
name: "bundle-lock"
section: "1"
platform: "macos"
package: "ruby"
version: "175"
release: "macOS 26.5"
platforms: ["linux", "macos"]
url: "https://new.carta.tech/bundle-lock"
---

# bundle-lock(1)

Creates / Updates a lockfile without installing

## NAME

**bundle-lock** - Creates / Updates a lockfile without installing

## SYNOPSIS

**bundle lock** \[--update\] \[--local\] \[--print\] \[--lockfile=PATH\] \[--full-index\] \[--add-platform\] \[--remove-platform\] \[--patch\] \[--minor\] \[--major\] \[--strict\] \[--conservative\]

## DESCRIPTION

Lock the gems specified in Gemfile.

## OPTIONS

- **--update=\<\*gems\>**

  Ignores the existing lockfile. Resolve then updates lockfile. Taking a list of gems or updating all gems if no list is given.

- **--local**

  Do not attempt to connect to **rubygems.org**. Instead, Bundler will use the gems already present in Rubygems´ cache or in **vendor/cache**. Note that if a appropriate platform-specific gem exists on **rubygems.org** it will not be found.

- **--print**

  Prints the lockfile to STDOUT instead of writing to the file system.

- **--lockfile=\<path\>**

  The path where the lockfile should be written to.

- **--full-index**

  Fall back to using the single-file index of all gems.

- **--add-platform**

  Add a new platform to the lockfile, re-resolving for the addition of that platform.

- **--remove-platform**

  Remove a platform from the lockfile.

- **--patch**

  If updating, prefer updating only to next patch version.

- **--minor**

  If updating, prefer updating only to next minor version.

- **--major**

  If updating, prefer updating to next major version (default).

- **--strict**

  If updating, do not allow any gem to be updated past latest --patch \| --minor \| --major.

- **--conservative**

  If updating, use bundle install conservative update behavior and do not allow shared dependencies to be updated.

## UPDATING ALL GEMS

If you run **bundle lock** with **--update** option without list of gems, bundler will ignore any previously installed gems and resolve all dependencies again based on the latest versions of all gems available in the sources.

## UPDATING A LIST OF GEMS

Sometimes, you want to update a single gem in the Gemfile(5), and leave the rest of the gems that you specified locked to the versions in the **Gemfile.lock**.

For instance, you only want to update **nokogiri**, run **bundle lock --update nokogiri**.

Bundler will update **nokogiri** and any of its dependencies, but leave the rest of the gems that you specified locked to the versions in the **Gemfile.lock**.

## SUPPORTING OTHER PLATFORMS

If you want your bundle to support platforms other than the one you´re running locally, you can run **bundle lock --add-platform PLATFORM** to add PLATFORM to the lockfile, force bundler to re-resolve and consider the new platform when picking gems, all without needing to have a machine that matches PLATFORM handy to install those platform-specific gems on.

For a full explanation of gem platforms, see **gem help platform**.

## PATCH LEVEL OPTIONS

See bundle update(1) *bundle-update.1.html* for details.