Installing on Linux

For a full list of minimum and recommended hardware specifications and tested GPUs, see the Mari technical specification on our website: https://www.foundry.com/products/mari/requirements

Mari 7.1 is available to download from our website at https://www.foundry.com/products/mari. The download is in a compressed .run format.

1.   Download the .run installation file from our web site.
2.   Extract Mari from the .run archive with the following terminal command, replacing <version number> with the current version:

sudo ./Mari<version number>-linux-x86-release-64.run

The installer displays the End User Licensing Agreement (EULA) and prompts you to accept it.

3.   If you agree with the EULA, enter y and press Return to accept the EULA. (If you don’t agree with the EULA and press n instead, the installation is canceled.)

By default, Mari is installed in an appropriately named folder in the current working directory.

Note:  If you leave out sudo from the terminal command, you need to ensure that you have sufficient
permissions to install Mari under your current working directory or selected target directory.

After the Mari application files have been installed, the installer also runs a post-installation script that creates the following directory: /usr/local/foundry/RLM

If you don’t have sufficient permissions on the /usr/local folder for this directory to be created, the post-installation script prompts you for your sudo password as necessary.

Tip:  You can also use the following options after the terminal command when installing Mari:
--info
This lets you see what the default installation directory is.
-- target MyMariDirectory
This lets you specify a different directory to install Mari to (in this case, MyMariDirectory).
--accept-eula
This lets you automate the installation so that you are not prompted to accept the EULA.
-- help
This lets you see additional help and installer options.
Here’s an example of the syntax using the --accept-eula option: sudo ./Mari<version number>-linux-x86-release-64.run --accept-eula

Launching on Linux

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

1.   Open a terminal.
2.   Navigate to the directory you installed Mari to.
3.   Enter ./mari
4.   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.

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.

5.   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 project caches, archive the project.

Warning:  Don’t 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.

Tip:  You can also launch Mari in verbose mode by using the following command:
./mari --verbose

This way, Mari provides a running log of each action that it performs. You can see this log in a terminal window.

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

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, navigate to the Mari application directory and enter:

./mari --nc

Note:  The default install location on Linux is:
/usr/local/Mari<version>

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 Linux

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 subscription license, activation key, node locked license, or a floating license and server running the Foundry Licensing Tools (FLT):

• Subscription Licenses - 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 Installing on Linux.

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: /home/<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.
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 the following command in a terminal shell:

/usr/local/foundry/LicensingTools7.0/bin/systemid

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 web site, 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's 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 Linux 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 Licensing on Linux 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 Licensing on Linux 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 2024.1223 permanent 2 share=h min_timeout=30

start=23-jan-2024 issuer=sf issued=23-jan-2024 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 Linux.

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 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 Linux

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

Note:  Make sure you have the right permissions to uninstall an application on your Linux system.

8.   Navigate to where you installed Mari to delete the application folder of the required version of Mari.
9.   Delete, rename, or move the .config/TheFoundry/ folder located in your home directory. You can use the $HOME environment variable to check the path to your home directory.
10.   Delete, rename, or move your Mari folder by navigating to: /home/<USERNAME>.

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

11.   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.
12.   Delete your Mari environment variables.

Article:  The procedures on how to delete environment variables on a Linux operating system vary depending on which version of Linux you are using.
For more information, see How to delete/unset environment variables.

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