Configuring the Mathematica mathpass File to Point to Concurrent License Server

What is a 'mathpass' file?

Client machines running the Mathematica software will have a 'mathpass' file which tracks licensing information for that machine. Depending on your OS, it can be found in a few different places on your machine:


  • C:\ProgramData\Mathematica\Licensing\mathpass
  • C:\Users\<user>\AppData\Roaming\Mathematica\Licensing\mathpass
  • C:\Program Files\Wolfram Research\Mathematica\Configuration\Licensing\mathpass

where <user> is your username on the computer.
Note that you may need to adjust a setting to show hidden files.


  • /Library/Mathematica/Licensing/mathpass
  • ~/Library/Mathematica/Licensing/mathpass

These files may be hidden on your computer. To navigate to a hidden folder, open the Finder application. Press Command + Shift + G to open a file search dialog and enter “~/Library/Mathematica/”. Finder opens the hidden folder.


  • /usr/share/Mathematica/Licensing/mathpass
  • ~/.Mathematica/Licensing/mathpass
  • /usr/local/Wolfram/Mathematica/Configuration/Licensing/mathpass

On Linux you may need to show hidden files using Control + H.

How do I configure a mathpass file to point to the UO license server?

To "point" your local installation of Mathematica to another license source, in this case the UO license server, you will need to add a line to your mathpass file:

  1. Open your mathpass file at one of the locations listed above.
  2. Your mathpass file may contain one or more lines -- each line provides licensing information for one license source. On application startup, it will search for a valid license from the beginning of the list to the end of the list, finally stopping once it finds a valid license. You can find out more about reading the contents of your mathpass file at the Wolfram Knowledgebase.
  3. Add/insert the following line: ! 
  4. Save and close the mathpass file.

The next time you start up Mathematica, the UO license server will be an available license source!

Getting Help

More information on this topic is available at the Wolfram Knowledgebase.

You can also request help from the Site-Licensed Software Service Request portal.


Article ID: 86915
Fri 9/13/19 1:27 PM
Fri 9/13/19 3:04 PM