Reference

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.

History

--gemfile until Debian 13 (Trixie); --quiet until Debian 13 (Trixie).