Wolfram Computation Meets Knowledge

How do I set up grid Mathematica Server with the Lightweight Grid Manager on macOS?

Read this article in: Deutsch, Español, Français, 日本語, 한국어, Português, Русский

In order to set up gridMathematica Server, we will


Install gridMathematica Server on a Compute Node

  1. Log in to your machine using an account that has administrative privileges.
  2. Quit any previous installations of Wolfram products that are running on your machine.
  3. If you already have an older gridMathematica Server installed in your Applications folder, uninstall the previous application.
  4. Installing from a downloaded file: Double-click the icon to start the installation.
    Installing from a DVD or a USB drive: Insert the DVD or connect the USB drive to your computer.

    The gridMathematica Server installer window appears.

  5. Double-click the icon to start installation. The Install gridMathematica Server dialog appears.
  6. Click Continue to begin the installation process. The Destination Select step proceeds automatically. The Installation Type step appears next.
  7. Click Install to proceed. A dialog window appears.
  8. Enter the user account credentials and click Install Software to continue. The installation starts.

    The gridMathematica Server Configuration dialog window appears. Note that it may be hidden behind other active windows.

  9. Click OK to continue. The User Account description dialog window appears.
  10. Click Continue. The user account selection dialog window appears.
  11. Select Local to create a new local user account. Click OK to continue.

    The Select New User dialog appears.

  12. We recommend “wolframgrid” as the name for the local user account. Click OK to confirm your selection.

    The User Account Password dialog window appears.

  13. Choose and enter a password for this new Local User Account. Click OK to continue. Confirm the Local User Account password.

    A dialog window appears, indicating that the account was created.

  14. Click OK to continue. The Web Interface Admin Account dialog window appears.
  15. Choose and enter a password for the web interface that configures the Apache Tomcat server. Choose a password and click OK to continue. Confirm the web interface admin password.

    The installation is now complete.

  16. Close this dialog window by clicking Close. An Installation Complete dialog window opens.
  17. Click Finish. The web interface launches automatically. We will return to the web interface when testing a gridMathematica kernel.



  1. Open the Finder.
  2. Navigate to the Applications directory.
  3. Hold the Control key and click gridMathematicaServer.app.
  4. Select Show Package Contents.
  5. Navigate to Contents ► macOS.
  6. Start the Mathematica component of gridMathematica Server by double-clicking Mathematica. A terminal window opens in order to start the application, then the Welcome to Wolfram Mathematica window appears.
  7. Activate gridMathematica Server.
  8. Close the terminal.

Activation of gridMathematica Server is now complete.


Test a gridMathematica Kernel

  1. Return to the web browser from the end of the Installation section, or open a web browser and navigate to localhost:3737. The main Status page appears.
  2. The left panel indicates any gridMathematica Servers visible on the local network, including the one that was just installed.

    Navigate to Kernel Settings ► Services.

  3. Click the Open Kernel link to open a kernel. A warning message appears.

  4. Confirm the warning message by clicking OK. A Wolfram kernel attempts to start.
  5. Wait for the Wolfram kernel to initialize. A connection status appears.
  6. Verify that the kernel state is Available.

The configuration of the Lightweight Grid Manager is now complete and tested.

Is this article helpful?

Any comments?

Thank you for your feedback.


Contact Support

Whether you have a question about billing, activation or something more technical, we are ready to help you.

1-800-WOLFRAM (+1-217-398-0700 for international callers)

Customer Support

8am–5pm US Central Time

  • Product registration or activation
  • Pre-sales information and ordering
  • Help with installation and first launch

Advanced Technical Support (for eligible customers)

8am–5pm US Central Time

8:30–10am & 11am–5pm US Central Time

  • Priority technical support
  • Product assistance from Wolfram experts
  • Help with Wolfram Language programming
  • Advanced installation support