---
name: "bundle-doctor"
section: "1"
platform: "linux"
package: "ruby-bundler"
version: "4.0.3-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux", "macos"]
url: "https://new.carta.tech/bundle-doctor"
---

# bundle-doctor(1)

Checks the bundle for common problems

## NAME

**bundle-doctor** - Checks the bundle for common problems

## SYNOPSIS

**bundle doctor \[diagnose\]** \[--quiet\] \[--gemfile=GEMFILE\] \[--ssl\]\
 **bundle doctor ssl** \[--host=HOST\] \[--tls-version=TLS-VERSION\] \[--verify-mode=VERIFY-MODE\]\
 **bundle doctor** help \[COMMAND\]

## DESCRIPTION

You can diagnose common Bundler problems with this command such as checking gem environment or SSL/TLS issue.

## SUB-COMMANDS

### diagnose (default command)

Checks your Gemfile and gem environment for common problems. If issues are detected, Bundler prints them and exits status 1. Otherwise, Bundler prints a success message and exits status 0.

Examples of common problems caught include:

- •

  Invalid Bundler settings

- •

  Mismatched Ruby versions

- •

  Mismatched platforms

- •

  Uninstalled gems

- •

  Missing dependencies

-

  **OPTIONS**

- **--quiet**

  Only output warnings and errors.

- **--gemfile=GEMFILE**

  The location of the Gemfile(5) which Bundler should use. This defaults to a Gemfile(5) in the current working directory. In general, Bundler will assume that the location of the Gemfile(5) is also the project's root and will try to find **Gemfile.lock** and **vendor/cache** relative to this location.

- **--ssl**

  Diagnose common SSL problems when connecting to https://rubygems.org.

-

  This flag runs the **bundle doctor ssl** subcommand with default values underneath.

### ssl

If you've experienced issues related to SSL certificates and/or TLS versions while connecting to https://rubygems.org, this command can help troubleshoot common problems. The diagnostic will perform a few checks such as:

- •

  Verify the Ruby OpenSSL version installed on your system.

- •

  Check the OpenSSL library version used for compilation.

- •

  Ensure CA certificates are correctly setup on your machine.

- •

  Open a TLS connection and verify the outcome.

-

  **OPTIONS**

- **--host=HOST**

  Perform the diagnostic on HOST. Defaults to **rubygems.org**.

- **--tls-version=TLS-VERSION**

  Specify the TLS version when opening the connection to HOST.

-

  Accepted values are: **1.1** or **1.2**.

- **--verify-mode=VERIFY-MODE**

  Specify the TLS verify mode when opening the connection to HOST. Defaults to **SSL\_VERIFY\_PEER**.

-

  Accepted values are: **CLIENT\_ONCE**, **FAIL\_IF\_NO\_PEER\_CERT**, **NONE**, **PEER**.