Generate a bug report

The Tailscale support team can help troubleshoot certain issues based on diagnostic logs. If you are working with the support team to troubleshoot an issue, you might be asked to create a bug report. A bug report is a random indicator that marks a section of the diagnostic logs to give us better visibility into what is occurring at a specific time, which can help make triage easier.

To generate a bug remote, you must be directly using the device—a bugreport cannot be generated remotely.

A bug report looks like this:

BUG-1b7641a16971a9cd75822c0ed8043fee70ae88cf05c52981dc220eb96a5c49a8-20210427151443Z-fbcd4fd3a4b7ad94

The value of a bug report shares no personally-identifiable information, and is unused unless you share the bug report with our team.

You can generate a bug report by using the Tailscale client applications, or the bugreport command in the Tailscale CLI.

After you generate a bug report, copy and paste the value that you can then share when you contact support.

Generating a bug report by using the client application

macOS
  1. Hold the Option key and click the Tailscale icon in the menu bar.
  2. Click Debug and then click Bug report.
  3. Click Copy report ID to copy the bug report.
Windows
  1. Hold the Shift key and click the Tailscale icon in the menu bar.
  2. Click Debug and then click Bug report.
  3. Click Copy report ID to copy the bug report.
Android
  1. Click Bug report from the application menu.
  2. Click Copy report ID to copy the bug report.
iOS
  1. Click Bug report from the application menu.
  2. Click Copy report ID to copy the bug report.

Generating a bug report by using the CLI

The Tailscale CLI is supported only for Linux, macOS, and Windows.

Run the bugreport command:

tailscale bugreport

If you are using macOS and you haven’t set your system path to include the Tailscale command executable, you need to specify the path to tailscale. For example:

/Applications/Tailscale.app/Contents/MacOS/Tailscale bugreport

You can use the following flags with the bugreport command:

  • --diagnose Prints additional verbose information about the system to the Tailscale logs after generating a bugreport identifier, which can then be viewed by our support team. Defaults to false.
  • --record Pause and then write another bugreport. Use this flag to create an initial bugreport identifier. During the pause, perform the action that reproduces your issue. Then, press Enter to create a second bugreport identifier. Share both bug identifiers with our team. Defaults to false.

Last updated

WireGuard is a registered
trademark of Jason A. Donenfeld.

© 2023 Tailscale Inc.

Privacy & Terms