Deploy MathType services with Java

Use this guide when you want to deploy MathType Services (Editor Services and Hand Services) on your own Java infrastructure instead of using the WIRIS-hosted services. This deployment model is suitable for organizations that require self-hosted services because of security, compliance, network isolation, or infrastructure requirements.

After completing this guide, you will have a self-hosted Java deployment that includes:

• MathType Editor Services.
• MathType Hand Services.

These services will be available for use by your MathType Integration Services or by applications that communicate directly with MathType Services.

Before you begin

Requirements

• A supported Java application server (for example, Apache Tomcat).
• The licensed MathType Services package for Java.
• A valid MathType server license.
• Basic understanding of the MathType integrations architecture.

Applies to

Self-hosted MathType Services · Java

Steps

Deploy the WAR files

Deploy the licensed WAR files provided with your MathType license to your Java application server. The deployment package includes:

• Editor Services, which provide formula editing and rendering capabilities.
• Hand Services, which provide handwriting recognition capabilities.

Deploy both applications using your application server's standard deployment procedure. For example, with Apache Tomcat, copy the WAR files into the webapps directory and restart the server.

Once deployment is complete, the application server should extract both WAR files and make them available through their configured context paths.

Configure the product keys

MathType Services require a valid product key. Each application contains its own configuration file:

• WEB-INF/web.xml (Editor Services)
• WEB-INF/web.xml (Hand Services)

Configure the appropriate product key in each application before using the services.

Restart the application server

After updating the configuration, restart your Java application server. The product keys are validated during application startup.

Verify the deployment

Verify that both applications are running correctly.

Verify Editor Services

Open the Editor Services test page:

http://<your-domain>/editor/tests/en/test.html

The page should load the MathType Editor test interface. You can also verify formula rendering directly:

http://<your-domain>/editor/render?mml=<math><mi>x</mi></math>

Verify Hand Services

Open the Hand Services test page:

http://<your-domain>/hand/tests/en/test.html

The page should load the handwriting editor and allow you to recognize handwritten mathematical expressions.

Troubleshooting

The render endpoint returns a licensing error

Verify that:

• The correct product key has been configured.
• The application server has been restarted.
• The WEB-INF/web.xml file corresponds to the deployed WAR version.

Integration Services cannot communicate with MathType Services

Verify that:

• Both applications are running.
• The render endpoint is accessible directly.
• Integration Services are configured with the correct service URLs.

Next steps

Once the deployment has been verified:

• Configure Integration Services to communicate with your self-hosted MathType Services.
• Validate the complete deployment using Test Integration Services.