SUMMARY
This article shows how to launch Nuke, NukeX, Nuke Studio or Hiero in safe mode. This is useful for troubleshooting problems you may encounter.
MORE INFORMATION
When Nuke runs in safe mode it will not load any third-party plugins or user customizations, such as Python scripts and Gizmos, and only runs using the contents of the Nuke install directory.
It specifically prevents the loading of custom python plugins and export presets on startup and stops any scripts or plugins in ~/.nuke and $NUKE_PATH locations from being executed. OFX plugins are also prevented from being loaded (including FurnaceCore and Keylight).
Nuke's safe mode can help determine if any problems you encounter are caused by user customizations and/or third-party plugins or if they happen with the core Nuke install.
Any Nuke sessions launched in safe mode will also load with the default Preferences settings, so safe mode may also help determine if an issue is caused by any changes made to the Preferences.
LAUNCH INSTRUCTIONS
You can launch Nuke/NukeX/Nuke Studio/Hiero in safe mode from a command prompt or terminal with the --safe flag. Exact steps are below.
The commands below are to launch Nuke 17.0v4 in safe mode, if you are running a different version then please change the command to your version of Nuke.
These instructions also assume that you have Nuke installed to the default location, so if you have installed Nuke to a different location, you may need to alter the command appropriately.
You can launch Nuke's different modes in safe mode by adding the --safe flag to the command:
Windows
Nuke
"C:\Program Files\Nuke17.0v4\Nuke17.0.exe" --safeNukeX:
"C:\Program Files\Nuke17.0v4\Nuke17.0.exe" --safe --nukexHiero:
"C:\Program Files\Nuke17.0v4\Nuke17.0.exe" --safe --hieroNuke Studio:
"C:\Program Files\Nuke17.0v4\Nuke17.0.exe" --safe --studioNuke Assist:
"C:\Program Files\Nuke17.0v4\Nuke17.0.exe" --safe --nukeassistHiero Player:
"C:\Program Files\Nuke17.0v4\Nuke17.0.exe" --safe --playerNuke Indie:
"C:\Program Files\Nuke17.0v4\Nuke17.0.exe" --safe --indieNuke Non-commercial:
"C:\Program Files\Nuke17.0v4\Nuke17.0.exe" --safe --ncHowever, to launch Nuke Non-commercial in other modes, you will also need to include an additional flag for the required mode. For example, to launch Nuke Studio as Non-commercial, you would use the following command:
"C:\Program Files\Nuke17.0v4\Nuke17.0.exe" --safe --nc --studioLinux
Nuke
/usr/local/Nuke17.0v4/Nuke17.0 --safeNukeX:
/usr/local/Nuke17.0v4/Nuke17.0 --safe --nukexHiero:
/usr/local/Nuke17.0v4/Nuke17.0 --safe --hieroNuke Studio:
/usr/local/Nuke17.0v4/Nuke17.0 --safe --studioNuke Assist:
/usr/local/Nuke17.0v4/Nuke17.0 --safe --nukeassistHiero Player:
/usr/local/Nuke17.0v4/Nuke17.0 --safe --playerNuke Indie:
/usr/local/Nuke17.0v4/Nuke17.0 --safe --indieNuke Non-commercial:
/usr/local/Nuke17.0v4/Nuke17.0 --safe --ncHowever, to launch Nuke Non-commercial in other modes, you will also need to include an additional flag for the required mode. For example, to launch Nuke Studio as Non-commercial, you would use the following command:
/usr/local/Nuke17.0v4/Nuke17.0 --safe --nc --studiomacOS
Prior to Nuke 12, the default command for macOS also included the v# for the application name. For example: /Applications/Nuke11.3v6/Nuke11.3v6.app/Contents/MacOS/Nuke11.3v6 --safe
Nuke
/Applications/Nuke17.0v4/Nuke17.0v4.app/Contents/MacOS/Nuke17.0 --safeNukeX:
/Applications/Nuke17.0v4/Nuke17.0v4.app/Contents/MacOS/Nuke17.0 --safe --nukexHiero:
/Applications/Nuke17.0v4/Nuke17.0v4.app/Contents/MacOS/Nuke17.0 --safe --hieroNuke Studio:
/Applications/Nuke17.0v4/Nuke17.0v4.app/Contents/MacOS/Nuke17.0 --safe --studioNuke Assist:
/Applications/Nuke17.0v4/Nuke17.0v4.app/Contents/MacOS/Nuke17.0 --safe --nukeassistHiero Player:
/Applications/Nuke17.0v4/Nuke17.0v4.app/Contents/MacOS/Nuke17.0 --safe --playerNuke Indie:
/Applications/Nuke17.0v4/Nuke17.0v4.app/Contents/MacOS/Nuke17.0 --safe --indieNuke Non-commercial:
/Applications/Nuke17.0v4/Nuke17.0v4.app/Contents/MacOS/Nuke17.0 --safe --ncHowever, to launch Nuke Non-commercial in other modes, you will also need to include an additional flag for the required mode. For example, to launch Nuke Studio as Non-commercial, you would use the following command:
/Applications/Nuke17.0v4/Nuke17.0v4.app/Contents/MacOS/Nuke17.0 --safe --nc --studio
NEXT STEPS
If launching Nuke/NukeX/Nuke Studio/Hiero in safe mode resolves your issue, then it is likely that a customization or plugin is cause for the problem you are encountering.
We would first recommend renaming your ~/.nuke folder, as this will force Nuke to create a new one upon launch. Then gradually reintroduce the files from the original folder (for example, the prefrences17.0.nk and any Python scripts) to the new one until you encounter the issue again. This may help you to determine what is causing the problem. The following article provides more detailed instructions for how you may go about this:
Q100475: How to troubleshoot issues with the .nuke directory
Customizations can also be added to several different locations, of which you can find a listed in the Nuke documentation:
Loading Gizmos, NDK Plug-ins, and Python and Tcl Scripts
You can also launch Nuke in verbose mode to see what plug-ins/custom scripts are installed. More information about launching Nuke in verbose mode can be found in the following article:
Q100112: Launching Nuke in verbose mode and isolating potential customizations causing issues
FURTHER HELP
If you have tried the steps above, and you are still unable to determine the cause of the problem, then please open a Support ticket and let us know the exact issue you are encountering and the troubleshooting steps you have taken so far. For more information on how to open a Support ticket, please refer to our Q100064: How to raise a support ticket article.
We're sorry to hear that
Please tell us why