Video Copilot - Tools for Digital Artists
FAQ And Troubleshooting

Optical Flares does not start / can't find the license / is crashing / producing strange things, what can i do?

Check out this FAQ, we provide helpful installation and trouble shooting tips here. The most important step for trouble shooting and finding issues is to check the Optical Flare debug log. The debug output will be prompted to the console. You have to enable debug output for that by setting the environment variable OPTICAL_FLARES_VERBOSE_CONSOLE to true. (Mac users please note that the shell is hidden by default on Mac, you have to start Nuke from the command line in this case)


How do i set an environment variable?

Environment variables provide an extremely convenient way to control application behaviour, especially in bigger environments. There are numerous ways how to set them and they are different on each operating system. The easiest way is to let nuke control your environment variables specifically for Nuke. You can set this by editing your configuration file:

os.environ['OPTICAL_FLARES_VARIABLE'] = 'content'


Optical Flares can't detect the license but i have installed it correctly. What should i do?

Check the output of your optical flares debug log. It will show you the exact location of your license file. If it is there and can be accessed, it might be broken. Please contact support.


I have a render farm and multiple render farm licenses but they are all stored on the same server. Now the render farm version is a separate plugin, how do i distinguish both versions.

You have to configure nuke accordingly so that it loads up the correct plugin version. You can do this by ammending your file in this way:

if nuke.env['gui']:




Note: You can do the same for different license files by altering the license path variable instead.


If i start Nuke on Windows manually all runs fine, but if i open a .nk script, i don't get a valid license anymore.

Nuke is changing it's home directory to the .nk file and thus licensing renders invalid. You have to adjust your OPTICAL_FLARES_LICENSE_PATH to a hardwired license location.

© 2005-2024 Video Copilot and Final Image Inc. - Contact