Create a ticket

Q100041: Mari launch issues


This article explains possible causes why Mari could have problems launching without providing a specific error message.


There are several possible causes for Mari not launching or crashing on launch.
The most common ones are:

1) Your machine is using Intel HD Graphics (not supported)
2) You do not have permissions for your config files
3) Your PYTHONHOME environment variable is set to a different Python version or an invalid directory.


1) Intel HD graphics are not supported by Mari. You will require an NVIDIA or AMD graphics card with the latest drivers. More details for system requirements can be found here. If you are using a laptop with 2 GPUs, this article explains how to assign your dedicated GPU to Mari.

2) Navigate to your Mari config folder and recursively change the permissions of the entire folder containing all files. The method of changing permissions can vary between OS. On Linux and Mac systems this is done best through the chmod command, whilst on Windows it is best to select the .mari folder in your home area and giving full access for your user account to this folder and all subfolders and files.
3) Mari 3.0 upgraded from Python 2.6 to Python 2.7. Many pipelines are built around the use of Python 2.6 and make use of the PYTHONHOME environment variable to point to a specific python install. If this variable is pointing to an invalid directory or out-of-date version of Python this might cause a crash or disable selected features. Unsetting the environment variable before the launch of Mari will solve those issues as Mari will use it's own Python install.



If you are still seeing any issues after performing the steps outlined in this article, then please open a Support ticket and let us know the issue you are encountering and the troubleshooting steps you have taken so far. The information we require to investigate is outlined under Q100090: Reporting a Mari issue .
For more information on how to open a Support ticket, please refer to the 'Using the Support Portal' article.

Keywords: Mari, startup, crash, no error, permission, intel, GPU, PYTHONHOME, Python
Was this article helpful?

We're sorry to hear that

Please tell us why
2 out of 23 found this helpful