bugreport Git Command Guide

The git bugreport command collects system and Git configuration information into a tarball to help diagnose problems. It packages logs, configuration, and environment details for submitting bug reports to the Git project.

git bugreport Syntax:

git bugreport [options] [<prefix>]

Options:

Option	Description
—suffix=	Specify the format for the timestamp suffix
-o , —output=	Save bug report to specified file
-t
-s	Include git config —show-origin output

Parameters:

Parameter Description Prefix for the bug report file name

Caution

Bug reports may include sensitive information; review the generated tarball before submitting.

git bugreport Command Samples:

Generate a standard bug report

git bugreport

Creates a tarball named bugreport-.tar.gz with system and Git information.

Save report with custom name

git bugreport --output issue-123.report

Saves the bug report to a specific file.

Include git config details

git bugreport -s

Adds git config —show-origin output to the report.

Tip

Submit the bug report to https://github.com/git/git/issues for issues with Git itself.

How do I generate a Git bug report?

To generate a bug report, run:

git bugreport

How can I specify a custom output file for the bug report?

To specify a custom output file, use:

git bugreport --output custom-report.tar.gz

Note

This command is for reporting bugs to the Git project; for general repo issues, use git log and other diagnostic commands.

Applications of the git bugreport command

1. Collecting system information when encountering Git bugs
2. Packaging configuration data for support requests
3. Preparing reports for Git contributors and maintainers
4. Diagnostic information gathering for troubleshooting
5. Including environment details in Git issue submissions