Skip to content

Troubleshooting

First steps

Before creating an issue, please check the following:

  • Avoid duplicates - look through open and closed issues sections and make sure your problem is not reported by another user

  • Make sure you’re using the latest build of Blender Launcher from releases

  • If Blender 3D is closing right after running it from Blender Launcher, the problem is probably in the build itself or in configuration files

  • For general questions go to Blender Artists thread or our Discord

Catching Application Traceback

  • Starting from version 1.14.0 Blender Launcher ships with separate debugging releases that used to provide deeper and more user friendly way of tracing an issue:
  1. Download Blender_Launcher_v%.%.%_%_x64_DEBUG.zip for your system and reproduce the issue faced in a regular version
  2. If something goes wrong the popup window with detailed information will be shown
  3. Copy the text from the window using Ctrl+C

  • Blender Launcher logs warnings and errors into BL.log by default. To retrieve additional useful debug information use -debug flag (compatible with debugging releases):

    .\"Blender Launcher.exe" -debug

    ./Blender\ Launcher -debug

  • On Linux it is possible to retrieve useful debug information using following command:

    gdb ./Blender\ Launcher
run

How to report a bug

To report a bug, use an issue template. Consider attaching a BL.log file if it exists near the Blender Launcher executable.

Submit an issue