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

# [NAME](#NAME)

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

# [SYNOPSIS](#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](#DESCRIPTION)

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

# [SUB-COMMANDS](#SUB)

## [diagnose (default command)](#diagnose_%28default_command%29)

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**](#quiet)

Only output warnings and errors.

[**--gemfile=GEMFILE**](#gemfile=GEMFILE)

The location of the [Gemfile(5)](/man/os/ruby3.4-bundler/Gemfile.5) which Bundler should use. This defaults to a [Gemfile(5)](/man/os/ruby3.4-bundler/Gemfile.5) in the current working directory. In general, Bundler will assume that the location of the [Gemfile(5)](/man/os/ruby3.4-bundler/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](#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**](#host=HOST)

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

[**--tls-version=TLS-VERSION**](#tls)

Specify the TLS version when opening the connection to HOST.

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

[**--verify-mode=VERIFY-MODE**](#verify)

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**.

April 2026

---

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