Q100081: Troubleshooting different types of Mari issues

Carlos

Updated : September 30, 2024 16:10

Created : March 21, 2016 17:34

SUMMARY

This article describes the essential steps to follow for identifying and solving various issues in Mari.

MORE INFORMATION

Safer mode

For most issues, it's worth trying to launch Mari in safer mode, as this test will temporarily reset your user preferences, customisations, and plugins, which may help you identify the source of the issue. Information on how to use safer mode for troubleshooting is available here:
Q100022: Using safer mode to launch Mari as a fresh install

Project corruption

If your project suddenly no longer opens and appears to be beyond retrieval then you may want to attempt to restore your project from a backup using the method described here: Q100039: Restoring a Mari project from a backup.

Viewport issues and missing geometry

As most issues with the Viewport are GPU related, you should always ensure you've updated your GPU driver to the latest version. You may also want to check if the geometry has any shortcomings like overlapping faces, incorrect normals, or topology issues.

If you're fully unable to see your asset in the View, please try the steps provided in the following article:
Q100278: What to do if the View becomes empty or the geometry disappears

Startup crash

Startup problems can have several causes. The most common causes and troubleshooting steps are explained here:
Q100041: Mari launch issues

Performance issues

This is dependent on the Project and on your Mari setup. We recommend checking the following two articles, as one describes best practices and setups for optimal performance, while the other could indicate which hardware component on your machine may be getting overloaded:

Q100188: Improving performance in Mari and in specific Projects
Q100078: Mari's usage of hardware components