Manually creating a remote kernel connection is a useful debugging tool. You should try this if you are having trouble connecting to a remote kernel.

  1. Start Mathematica on your local machine. On the toolbar, navigate to Evaluation ► Kernel Configuration Options….
  2. Add a new kernel and configure it. In the dialog, click Add, and a Kernel Configuration dialog appears.
  3. Enter an appropriate name for your remote kernel, such as RemoteMachine1.
  4. Under Basic Options, verify that “Launch on” is set to “Local machine”. Additionally, clear the field “Kernel Program.”
  5. Click the Advanced Options switch. In the text field called “Arguments to MLOpen,” enter:
    -LinkMode Listen -LinkProtocol TCPIP

  6. Click OK and open a new notebook.
  7. On the toolbar, navigate to Evaluation Notebook’s Kernel and click the name of the kernel that you just created.
  8. Inside the notebook, evaluate the command:

    Instead of printing Mathematica’s version number, a message box appears:

    MathLink Alert
    Link created on:

    After this message is a name that is called the linkname. Record this linkname so that you can use it later and click OK to close the dialog.

    The title bar of the notebook should still say Running… at the top.

  9. Connect to the remote machine and launch the Wolfram Language kernel there. Inside that kernel, run the command:
    $ParentLink = LinkConnect["linkname", LinkProtocol->"TCPIP"]

    Here, “linkname” is the linkname that you recorded earlier, wrapped in quotation marks. For example, if the linkname is:,

    Please run:

    $ParentLink = LinkConnect[",",
  10. The notebook that is open on the local machine now prints out the version of Mathematica that you remotely connected to. This indicates that the local machine is successfully using the remote kernel.