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

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:

       o   Invalid Bundler settings

       o   Mismatched Ruby versions

       o   Mismatched platforms

       o   Uninstalled gems

       o   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:

       o   Verify the Ruby OpenSSL version installed on your system.

       o   Check the OpenSSL library version used for compilation.

       o   Ensure CA certificates are correctly setup on your machine.

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


                                September 2025                BUNDLE-DOCTOR(1)