bundle-doctor1
Checks the bundle for common problems
Usage
bundle doctor
[diagnose]
[--quiet]
[--gemfile=GEMFILE]
[--ssl]
bundle doctor
ssl
[--host=HOST]
[--tls-version=TLS-VERSION]
[--verify-mode=VERIFY-MODE]
bundle doctor
help
[COMMAND]
Overview
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.lockandvendor/cacherelative 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.1or1.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.
Releases
4 releases since Debian 11 (Bullseye); the text changed 3 times.
--gemfile until Debian 13 (Trixie);
--quiet until Debian 13 (Trixie).