Wolfram Web Engine (WWE) requires the installation of Java JDK 25, Apache Tomcat 10, Wolfram Engine and MathLM. This guide walks you through the following steps to get WWE installed and running on macOS:

1. Installing Java JDK 25
2. Installing and Testing Apache Tomcat 10
3. Installing Wolfram Engine and Activating with MathLM
4. Installing and Testing WWE

Installing Java JDK 25

1. Download and run the Java JDK 25 installer. We recommend downloading either the ARM64 DMG Installer or the x64 DMG Installer under the macOS section depending on your computer’s architecture.

Installing and Testing Apache Tomcat 10

Installation

1. Download Apache Tomcat 10. We recommend downloading the ZIP file from the Core section under Binary Distributions.
2. Open a terminal and change to the directory where you downloaded the Tomcat ZIP file. For example:

   cd /Users/<UserName>/Downloads

3. Unzip the Tomcat installation file into the directory of your choice. For example, if you want to unzip the files into the /usr/local directory, run:

   sudo unzip apache-tomcat-<version>.zip -d /usr/local

4. Change to the Tomcat installation directory. For example, if you unzipped the Tomcat installation files into the /usr/local directory, run:

   cd /usr/local/apache-tomcat-<version>

5. To make the Tomcat scripts executable, run:

   sudo chmod -R u+x bin

Creating a Tomcat User Account (Recommended)

It is recommended that you set up a dedicated “tomcat” user account to run the Tomcat server.

1. Add a user account called “tomcat”.
2. Change the ownership of the Tomcat installation directory to the “tomcat” user account. For example, if you installed Tomcat in /usr/local, run:

   sudo chown -R tomcat /usr/local/apache-tomcat-<version>

Testing Tomcat

1. Run the following command from the Tomcat installation directory to start the Tomcat server as the “tomcat” user account:

   sudo -u tomcat ./bin/startup.sh

2. Open a web browser and enter “localhost:8080”. The Tomcat server has been installed successfully if the Tomcat landing page appears:

   

3. Run the following command from the Tomcat installation directory to stop the Tomcat server as the “tomcat” user account:

   sudo -u tomcat ./bin/shutdown.sh

Installing Wolfram Engine and Activating with MathLM

You need to install Wolfram Engine and MathLM, activate Wolfram Engine using MathLM and copy the Wolfram Engine licensing information into a system-accessible location on your machine.

Installing Wolfram Engine and MathLM

1. Follow steps 1–3 and 8–15 in the instructions for installing Wolfram Engine on macOS. You will be using a MathLM server to activate Wolfram Engine instead.
2. Follow the instructions for installing MathLM on macOS and Linux.

Activating Wolfram Engine with MathLM

1. Open a terminal and run the following command to change to the Wolfram Engine licensing directory:

   cd /Users/<username>/Library/WolframEngine/Licensing

2. Run the following command to create a file named “mathpass” in this directory.

   touch mathpass

3. Open the “mathpass” file with your preferred text editor.
4. Enter an exclamation mark followed by the hostname or IP address of your MathLM server. If you installed MathLM on the same machine you are running WWE on, use “localhost” as the hostname.

   !localhost

5. Save your changes to the “mathpass” file.
6. Run the following command to copy the “mathpass” file you created to the system-accessible Wolfram Engine licensing directory:

   sudo cp /Users/<username>/Library/WolframEngine/Licensing/mathpass /Library/WolframEngine/Licensing

   Note: You may need to create this directory manually if it does not already exist on your machine.

   Wolfram Engine is now activated.

Installing and Testing WWE

Installing WWE

1. Download the WWE installation file from your Wolfram Account.
2. Make sure the Tomcat server is running.
3. Run the following command from the location of the WWE installation file to copy it into the webapps subdirectory of the Tomcat installation directory:

   sudo cp webengine.war /usr/local/apache-tomcat-<version>/webapps/

   The WWE installation file will be automatically unpacked, and a webengine subdirectory will be created in the webapps directory.

4. To change the ownership of the webengine directory to the “tomcat” user, run:

   sudo chown -R tomcat /usr/local/apache-tomcat-<version>/webapps/webengine

5. Open /usr/local/apache-tomcat-<version>/webapps/webengine/WEB-INF/WWEConfiguration.xml with your preferred text editor.
6. Under the KernelPool section, replace the KernelExecutable value with “/Applications/Wolfram Engine.app/Contents/MacOS/WolframKernel”.

   <KernelExecutable>/Applications/Wolfram Engine.app/Contents/MacOS/WolframKernel</KernelExecutable>

7. Restart the Tomcat server.

Testing WWE

1. Open a web browser and enter “localhost:8080/webengine”. The WWE landing page appears.

   

2. Under Examples, click Active Web Object.

   

   The WWE installation was successful if you see a page that says “Welcome to Wolfram Web Engine”.

   If you receive an error, please contact server-support@wolfram.com.