Q100022: Using safer mode to launch Mari as a fresh install



This article shows how to run Mari in the different safe modes available starting with version 3.0, on all operating systems.


Starting with Mari 3.0v1, Mari includes --safe and --safer startup modes, similar to Nuke's, with different logging levels, which can help diagnose problems when running Mari.

When Mari runs in these modes it will run as if it were a fresh install version without your different custom settings or 3rd party plug-ins, depending on the level. When troubleshooting, this can help establish whether a problem is being caused by something the user changed in Mari, or if it's being caused by a core Mari component. Please note that this will not permanently reset Mari to its fresh install form, as once you reopen Mari without using a safe mode, you will revert to having all your user-defined configurations, plugins, etc. 

These safe modes run a number of options, described below.

If you prefer, you can choose to run individual safe mode options rather than those grouped under --safe or --safer. To do this, type the given number for the option after the --safe command. Please be aware that these work in an "up to and including" fashion. For example, if you use --safe=3 you will also run --safe=1 and --safe=2 (effectively, operating the same as running the --safe command).

The individual safe mode options are:

--safe=1  Disables startup Python scripts.

--safe=2  Disables user custom plug-ins.

--safe=3  Bypasses user Python libraries and is equivalent to --safe

--safe=4  Bypasses user settings.

--safe=5  Bypasses user environment variables and is equivalent to --safer

--safe=6  Disables any Python scripts in the Mari installation that have been tampered with.

--safe=7  Disables any Node Graph nodes in the Mari installation that have been tampered with.

--safe=8  Forces the nuke-default OCIO colorspace configuration.

If you are unsure if you should run these further debugging modes, please get in touch with Support for advice.



Safer mode is recommended for most troubleshooting scenarios, so we'll use it as an example. You can launch Mari in safer mode from a command prompt or terminal with the --safer flag. The exact steps using Mari's default install location for each OS are below, if you have Mari installed in a different directory, please change the file paths accordingly:

Run the following in a Command Prompt:
"C:\Program Files\Mari6.0v2\Bundle\bin\Mari6.0v2.exe" --safer


Run the following in a Terminal:
/usr/local/Mari6.0v2/mari --safer


MacOS X:
Open a Terminal from Applications > Utilities and run the following command (note this should all be on one line):
/Applications/Mari4.7v7/Contents/MacOS/Mari4.7v7 --safer
/Applications/Mari4.7v7/Mar4.7v7.app/Contents/MacOS/Mari4.7v7 --safer


Note: To run a mode other than --safer, replace --safer in the prompts above with the relevant mode, such as --safe=8.

    We're sorry to hear that

    Please tell us why