How To Enable Debug Logging for Box Tools

As a troubleshooting step for Box Tools, Box Product Support may request that you enable Box Tools debug logging.

• MacOS

• Windows EXE Version

• Windows MSI Version

MacOS

1. Press Command + Space to open Spotlight, type Terminal, then press Return.
2. Paste the following command into Terminal, then press Return:

   • defaults write com.Box.Box-Edit DebugLogsEnabled 1

3. Restart your computer to ensure the DebugLogsEnabled setting will take effect.

Windows EXE Version

1. Find the Box Tools icon in the System Tray.

2. Right-click on the Box Tools icon.

3. Select the "Enable Debug Logging" option.

Windows MSI Version

If you have the MSI version of Box Tools installed, you will have to turn Local Com debugging on by doing the following in addition to above :

1. Open the Registry Editor (Regedit).

2. Navigate to:

   • HKEY_LOCAL_MACHINE > SOFTWARE > Box > Box Local Com Service

3. Edit (create if not created) DebugLogging value and set it to 1.

4. Restart Box Local Com Server.

   1. Run services.msc.

   2. Find Box Local Com Service.

   3. Click Restart link at the left pane.

After turning on the debug option, reproduce the problem behavior and submit Box Tools logs by following the steps in this page.