Installing on Windows

System requirements for Windows machines can be found in and are also located on Foundry's website.

Mari 5.0 is available to download from our web site at https://www.foundry.com/products/mari. The download is in a compressed .exe format.

1.   Download the .exe installation file from our web site.
2.   Double-click on the installation file to start the installation. Follow the on-screen instructions. By default, Mari is installed to <drive letter>:\Program Files\Mari <version number>.
3.   That's it! Proceed with .

Installing from the Command Line

1.   Download the correct .exe installation file from our web site at https://www.foundry.com/products/mari.
2.   To open a command prompt window, select Start > All Programs > Accessories > Command prompt.
3.   Use the cd (change directory) command to move to the directory where you saved the installation file. For example, if you saved the installation file in C:\Temp, use the following command and press Return:

cd \Temp

4.   To install Mari, do one of the following:

• To install Mari and display the installation dialog, type the name of the install file without the file extension and press Return:

Mari5.0v4-win-x86-release-64

• To install Mari to a specified directory and display the installation dialog, use the /D install option:

Mari5.0v4-win-x86-release-64 /D="E:\Mari"

• To install Mari silently so that the installer does not prompt you for anything but displays a progress bar, enter /S after the installation command:

Mari5.0v4-win-x86-release-64 /S

• You can also use a combination of install options:

Mari5.0v4-win-x86-release-64 /S /D="E:\Mari"

Note:  The /D and /S commands are new to Mari 4.5v1. For versions prior to 4.5v1, use the /dir and /silent commands.

Note:  By running a silent install of Mari, you agree to the terms of the EULA. To see this agreement, please refer to End User License Agreement (EULA), or run the installer in standard non-silent mode.

Launching on Windows

Article:  Take a look at the Launching Mari in safe mode article.

Launching Mari on High-Resolution Monitors

On Windows 8.1 and 10, QT5 does not handle scaling properly on high-resolution monitors. Windows includes an in-built mode, called --dpiscaling=native, which displays Mari with the correct resolution. If you need to disable this mode, you can use the --dpiscaling=none mode.

To set the --dpiscaling=none mode:

1.   Before launching Mari, Shift+right-click on the Mari shortcut icon and select Properties.

The Mari 5.0v4 Properties window opens.

2.   In the Shortcut tab, in the Target field, type --dpiscaling=none after "C:\Program Files\Mari4.0v1\Bundle\bin\Mari4.0v1.exe". For instance, "C:\Program Files\Mari4.0v1\Bundle\bin\Mari4.0v1.exe" --dpiscaling=none.

Note:  The --dpiscaling=native mode is set by default but does not display in the Target field.

Launching Mari

1.   Click Start > All Programs > The Foundry > Mari 5.0v4 > Mari 5.0v4.
2.   If you haven’t installed a license for Mari, you need to choose from one of the options for . Once you’ve done so, click Launch in the Mari Licensing dialog.
3.   Mari checks for the most frequently used graphics cards, and if a graphics card configuration is detected that's not in the tested GPU hardware list, a dialog displays warning you about it. Depending on the configuration detected, you have the option to Quit or Continue and, in the case of configurations with known issues, also Ignore Permanently.

Note:  If you ignore the warning and run Mari anyway, you may experience instability or performance issues. If a tested graphics card configuration is detected, Mari runs as normal.

4.   If you are launching Mari for the first time, Mari selects a default cache directory for its project files. You can change this directory and select one of your own. In the Confirm Projects Directory dialog, navigate to the directory you want to use and click Choose.

The Mari graphical interface displays.

Please note that the project directory should be:

• empty

• local to the machine (not a network mount)

• as fast as possible

• a location that's not temporary (to avoid the data disappearing)

• a directory that the user has read and write permissions to.

Project cache locations are directories that Mari uses to store project data files. These directories must be persistent; not in temporary locations. If more than one project location is specified, Mari spreads each project’s data files across all locations. Once a project has been created for a given set of project cache locations, that set must not be changed. In order to move a project between different sets of caches, archive the project.

Note:  Do not add, remove, or amend project locations once they have been set unless they are empty. Once projects have been created for a given set of project cache locations, that set must not be changed or project corruption will occur.

Note:  If the MARI_CACHE environment variable has been set, its value is used to determine the location of the project cache files. In this case, Mari does not prompt you to select the project directory. For more information on environment variables that Mari understands, please refer to Environment Variables That Mari Recognizes.

Article:  Take a look at the Temporarily setting the project directory in Mari article.

Note:  You can also launch Mari in verbose mode by selecting Start > All Programs > Mari 5.0v4 > Mari 5.0v4 (Verbose Output). This way, Mari provides a running log of each action that it performs. You can see this log in a command line window.

5.   If you are upgrading, Mari prompts you if you'd like to import your user preferences from your previous installed version of Mari.

If you are launching Mari from the command line, you can run the application in one of two safe modes: --safe and --safer. The --safe mode:

• Disables startup Python scripts

• Disables custom user plug-ins

• Bypasses user Python libraries.

The --safer mode performs all of the above options as well as:

• Bypasses user settings.

• Bypasses user environment variables.

These safe modes are primarily used for debugging purposes. For advanced debugging methods, please see Frequently Asked Questions and Troubleshooting.

Mari Non-Commercial

If you want to try out or learn Mari, you can run Mari Non-commercial. This version allows you to explore most of Mari’s features, but prevents the commercial use of the application. For more information, see Mari Non-Commercial.

To launch the application in Non-Commercial mode, do one of the following:

• Double-click the Mari 5.0v4 (Non-commercial) icon on the Desktop.

• Using a command prompt, navigate to the Mari application directory and enter:

.\Mari5.0v4.exe --nc

Note:  The default install location on Windows is:
C:\Program Files\Mari<version>\Bundle\bin

If you have already activated Mari Non-commercial on the current device, the graphical interface appears, and a command line window opens. If you haven't activated the device yet, proceed to the next section.

Licensing on Windows

If you simply want to try out Mari, you can obtain a trial license, which allows you to run Mari for free for 15 days. See Install the License.

To use Mari after this trial period, you need either a valid subscriptionlicense, activation key, node locked license, or a floating license and server running the Foundry Licensing Tools (FLT):

• SubscriptionLicenses - allows you to activate a single license or entitlement on any authorized device up to the entitlement's maximum number of activations.

• Activation Keys - activation keys allow you to activate and generate your actual product license key, at a later point after purchase, on the machine for which you require the license. They are provided for both node locked and floating license, and generate the appropriate license type once installed using the product's Licensing dialog or online using the Activate a Product page: https://www.foundry.com/user/login?destination=/licensing/activate-product

• Node Locked Licenses - these can be used to license an application on a single machine. They do not work on different machines and if you need them to, you’ll have to transfer your license.

Node locked licenses, sometimes called uncounted licenses, do not require additional licensing software to be installed.

• Floating Licenses - these are used to license applications on any networked client machine. The floating license is put on the server and is locked to a unique number on that server.

Floating licenses, sometimes called counted licenses, require additional software to be installed on a server to manage the licenses and give them out to the client stations that want them. This software is called the Foundry Licensing Tools (FLT) and can be downloaded at no extra cost from our website.

The instructions below run through both licensing methods. You can also find a more detailed description in the Foundry Licensing Tools User Guide available on our website: https://www.foundry.com/licensing

Installing a Subscription License

Subscription licensing differs from traditional node locked or floating licenses in that a single license, or entitlement, is valid on any authorized device up to the entitlement's maximum number of activations.

• A Entitlement represents the right to run a Foundry product for a set amount of time on a set number of devices.

• An Authorized Device is a recognized device, such as a desktop computer, on which entitlements can be activated.

For example, if a Entitlement for Mari has two activations, you can use Mari on two separate Authorized Devices simultaneously. If you want to activate another device, you have to deactivate an existing one, but you can activate and deactivate devices as often as you like.

Subscription licenses require that you connect to the Internet at least every 30 days to extend your activation.

To authorize your device, follow these steps:

1.   Create a Foundry account using a valid e-mail address on our website at https://www.foundry.com/
2.   Launch Mari using any of the methods described in .

The Licensing dialog displays.

3.   Click Authorise Device.
4.   Enter your account e-mail address and password and then click Authorise Device.

A subscription license is created in your home directory: C:\Users\<username>\FoundryLicensing\<SystemID>

Note:  Replace <username> and <SystemID> with the current user and the MAC address of the device, respectively.

The license looks similar to this: c58edf7e-17ab-435b-8d8a-b3a9b347ab11.lic

5.   Once the license is installed, click Launch to start using Mari.

Note:  On Windows, there is a known issue with user names containing non-ASCII characters causing licensing to fail. If a licensing error similar to the following displays:
Unable to create subscription license directory: C:\Users\Zoë Hernández\FoundryLicensing\
Try changing the license directory to an alternate location using the FN_SUBSCRIPTION_LICENSE_DIR environment variable. See Setting Environment Variables for more information.

6.   If you need to deactivate an entitlement or deauthorize a device, navigate to Help > License and, click:

• Deactivate Mari to reclaim one of your entitlements,

• Deauthorize Device to reclaim your existing Foundry entitlements on this device and stop additional ones running, or

• Deauthorize All Devices to reclaim your existing Foundry entitlements on all devices associated with your account, and stop additional ones running.

Licensing on a Single Machine

Obtain an Activation Key

To obtain a license, you need your machine's System ID (sometimes called Host ID or rlmhostid). Just so you know what a System ID number looks like, here’s an example: 000ea641d7a1.

Note:  Bear in mind that, for floating licenses, you need the System ID of the license server, not the machines on which you intend to run Mari.

There are a number of ways you can find out your machine's System ID:

• Launch Mari without a license, click Status, and then scroll down the error report until you see your System ID.

• Download the Foundry License Utility (FLU) from https://www.foundry.com/licensing and run it. Your System ID is displayed.

• Download the Foundry Licensing Tools (FLT) free of charge from https://www.foundry.com/licensing and then run C:\Program Files\TheFoundry\LicensingTools7.0\ Foundry License Utility.exe

When you know your System ID, you can request a license for Foundry products:

• from Foundry's Sales Department at sales@foundry.com

• from the product pages on our website, such as https://www.foundry.com/products/mari

• by launching Mari without a license and selecting:

• Buy Mari - opens a web browser directly to Foundry website to purchase a license.

• Try Mari - displays the 15-day trial license download screen. Enter your Foundry account details or create a new account and follow the on-screen instructions to receive a trial license.

Note:  By default, if you have installed a temporary license, Mari displays a dialog at start-up alerting you to the number of days remaining. If you want to disable this behavior, you can set the FN_DISABLE_LICENSE_DIALOG environment variable to 1 to suppress the warning message about imminent license expiration. See Environment Variables That Mari Recognizesfor more information.

Install the License

You are prompted to enter your activation key when you start Mari without a license. Mari skips this step if you’ve already activated the application.

When you start the application before installing a license, a Licensing dialog displays an error, informing you that no license was available. The installation process is dependent on what type of license you requested:

• License file - if you requested a license file, typically foundry.lic, this option allows you to browse to the file location and install it automatically. See Licensing on Windows for more information.

• Activation Key or license text - if you requested an Activation Key or license by e-mail, this option allows you to paste the key or license text into the Licensing dialog, which then installs the license in the correct directory. See To install an Activation Key or license text for more information.

• A floating license - if you requested a floating license to supply licenses to multiple client machines, this option allows you enter the server address that supplies the client licenses.

Note:  You must install a floating license and additional software on the license server to use this option.

See Install Floating Licenses for more information.

Tip:  If you later want to check the current status of your license (for example, to see if it’s a node locked license or a floating license), select Help > License in Mari to display the Mari Licensing dialog.

To install a license from disk

1.   Save the license file to a known location on disk.
2.   Launch Mari.

The Licensing dialog displays.

3.   Click Install License to display the available license installation options.
4.   Click Install from Disk.
5.   Browse to the location of the license file.
6.   Click Open to install the license automatically in the correct directory.

The Licensing dialog opens showing you that the license is installed.

7.   Click Launch to start Mari.

To install an Activation Key or license text

1.   Launch Mari.

The Licensing dialog displays.

2.   Click Install License to display the available license installation options.
3.   Click Activation Key / License Text and then either:

• Enter the Activation Key string in place of Insert Activation Key Here. A license key typically looks something like this:

mari-0101-77d3-99bd-a977-93e9-8035

OR

• Copy the license text and paste it over the Copy/Paste license text here string. License text typically looks something like this:

LICENSE foundry mari_i 2022.1223 permanent 2 share=h min_timeout=30

start=23-jan-2022 issuer=sf issued=23-jan-2022 replace

_ck=6dd78e4c69 sig="60PG452MPDMMM6MJAMRGKNQAN3PEAK8JYTHN45022M0C98H

XFA9N7SAASMRABT8TUJ6FAMX8TWU0"

4.   Click Install.

The license is automatically installed on your machine in the correct directory.

Note:  Activation Keys require an internet connection. If you access the internet through a proxy server and cannot connect to the activation server, you may get an error dialog prompting you to either:

-Click Use Proxy to enter the proxy server name, port number, username, and password. This enables the application to connect to the activation server and obtain a license. The license is then installed automatically, or
-Click on the web link in the dialog and use the System ID (also known as hostid) provided to manually activate and install a license.

5.   Click Launch to start Mari.

Licensing over a Network

Obtain Floating Licenses

Alternatively, you can purchase a floating license key from our website.

1.   Display your system ID by doing one of the following:

• Launch Mari without a license, click Status, and then scroll down the error report until you see your System ID.

• Download the Foundry License Utility (FLU) from https://www.foundry.com/licensing and run it. Your System ID is displayed.

• Download the Foundry Licensing Tools (FLT) free of charge from https://www.foundry.com/licensing and then run C:\Program Files\TheFoundry\LicensingTools7.0\ Foundry License Utility.exe

2.   Once you have provided us with your System ID number and a license key has been generated for you, you’ll receive the license key in an e-mail or Internet download. The license key is contained in a text file called foundry.lic. For information on what to do with the foundry.lic file, see Licensing on Windows.

Install Floating Licenses

If you requested a floating license from Foundry, you will receive your license key (foundry.lic) in an e-mail or Internet download. You should also receive the Foundry License Utility (FLU) application to help you install the license key on the license server machine. The server manages licenses for the client machines on your network.

Note:  The FLU is also available to download from https://www.foundry.com/licensing

1.   Make sure you have saved both the license key (foundry.lic) and the Foundry License Utility application in the same directory.
2.   Run the FLU application.

The license key automatically appears in the FLU window if the FLU and foundry.lic are in the same directory.

Tip:  If they are not in the same directory, you can either copy and paste the contents of the license key or drag-and-drop the file into the FLU window.

3.   Click Install.

This checks the license file and, provided that the license is valid, installs it into the correct directory.

4.   In order for the floating license to work, you will need to install the Foundry Licensing Tools (FLT) on the license server machine.

For more information on how to install floating licenses, refer to the FLT User Guide, which you can download from our website https://www.foundry.com/licensing

5.   Once your license server is up and running, launch Mari on the client machine.
6.   Click Use Server and enter the server address in the field provided. The format for the server name is: <port>@<servername>, for example, 30001@red.

The Licensing dialog opens showing you that the license is installed.

7.   Click Launch to start Mari.

Note:  You must perform steps 5 and 6 on each client machine that requires a Mari license from the server.

Tip:  If you later need to display the Mari Licensing dialog again, you can select Help > License in Mari.

Further Reading

For more information on licensing Mari, displaying the System ID number, setting up a floating license server, adding new license keys and managing license usage across a network, you should read the Foundry Licensing Tools User Guide available on our website at: https://www.foundry.com/licensing.

Uninstalling on Windows

To uninstall Mari on Windows, there are a few things you need to do:

1.   Navigate to C:\Program Files\Mari5.0v4 and double-click Uninstall.

The Mari Uninstall dialog displays.

2.   Click Yes to uninstall the application files.

Tip:  You can also uninstall Mari silently, with no prompts or popups, from the Command Prompt or PowerShell by entering:
"C:\Program Files\Mari5.0v4\Uninstall.exe" /S

3.   Delete, rename, or move your .mari folder.

The .mari folder contains customized files such as preferences, workspaces, and so on.

The .mari folder is usually found under the directory pointed to by the HOME environment variable. If this variable is not set, which is common, the .mari directory is under the folder specified by the USERPROFILE environment variable, which is generally one of the following:

• drive letter:\Documents and Settings\login name\

• drive letter:\Users\<USERNAME>\

To find out if the HOME and USERPROFILE environment variables are set and where they are pointing at, enter %HOME% or %USERPROFILE% into the address bar in Windows Explorer. If the environment variable is set, the folder it’s pointing at is opened. If it’s not set, you get an error.

4.   Delete, rename, or move your Mari folder by navigating to drive letter:\Users\<USERNAME>\Documents\.

Note:  Note: This folder is an output folder and doesn’t affect the stability of Mari.

5.   Delete, rename, or move your Mari projects folder that contains your cached files. This folder resides in the location you picked when you created your first project.

Deleting Mari-related environment variables

To delete any Mari-related environment variables, do the following:

1.   Click on Start.
2.   Select Computer.
3.   Click System Properties.
4.   Click the Advanced system settings tab.
5.   Click the Environment Variables… button.

The Environment Variables dialog opens.

6.   Select any Mari-related environment variables and click Delete.

Article:  Take a look at the Uninstalling Mari article for more information.