Deploy Integration Services with Java

Use this guide when you want to host MathType Integration Services on a Java application server instead of using the default MathType cloud services.

After completing this guide, your MathType frontend integration will send requests to your own Java-based Integration Services deployment. This allows you to customize backend behavior and infrastructure settings while continuing to use MathType editor services.

Before you begin

Requirements

• A working MathType frontend integration (CKEditor, TinyMCE, Froala, Generic Integration, or another supported editor)..
• Access to a Java application server.
• The MathType Integration Services package for Java and a valid MathType server license (for self-hosting).
• Basic understanding of the MathType integrations architecture.

Applies to

Self-hosted MathType Integration Services · Java

Steps

Obtain the Java Integration Services package

Download the MathType Integration Services package for Java that matches your servlet containter. Available packages include:

• Java (javax.servlet) for containers such as Tomcat 9.
• Java Jakarta (jakarta.servlet) for containers such as Tomcat 10 or later.

You can find them here. The package contains the backend components required to process MathType requests and communicate with MathType editor services.

Deploy the Integration Services

Deploy the provided WAR file to your Java application server. Example:

pluginwiris_engine.war

After deployment, verify that the configuration endpoint is accessible:

https://your-server.com/pluginwiris_engine/app/configurationjs

At this point, your server should be able to receive requests from the MathType frontend.

Configure your frontend integration

Update your frontend integration to point to your Java Integration Services endpoint. Example:

mathTypeParameters: {
  serviceProviderProperties: {
    URI: 'https://your-server.com/pluginwiris_engine/app/configurationjs',
    server: 'java'
  }
}

The exact location of this configuration depends on the editor you are using.

4. Verify the deployment

Open the Integration Services test page:

https://your-server.com/pluginwiris_engine/app/test

Confirm that:

• The test page loads correctly.
• All available checks pass successfully.
• No configuration or permission errors are reported.

Verify it worked

Open your editor and check that:

• The MathType editor opens correctly
• Formulas can be inserted and edited
• Rendering behaves as expected

You can also inspect browser network requests and verify that requests are sent to your Integration Services endpoint instead of the default MathType cloud endpoints.

Common issues

The configuration endpoint returns 404

Verify that the WAR file was deployed successfully and that the application server started correctly.

The application does not start

Verify that the package matches your servlet container:

• Tomcat 9 requires the Java package based on javax.servlet.
• Tomcat 10 or later requires the Java Jakarta package based on jakarta.servlet.

Formulas are not rendered

Verify that the frontend is pointing to the correct Integration Services endpoint.

The editor opens, but formulas cannot be inserted

Check that the Integration Services endpoint is reachable and returning valid responses.

Related articles

• MathType integrations architecture.
• Deploy Integration Services with PHP.
• Test Integration Services.
• Configure Integration Services.