Configure MathType Integration Services

MathType Integration Services are configured through a deployment-specific configuration file. This guide explains where to find it, how to modify it, and how to verify your changes. Most deployments work with the default configuration. You only need to modify the configuration when adapting MathType to your infrastructure or application requirements.

After completing this guide, you'll know how to:

• Locate the Integration Services configuration file.
• Understand how configuration is applied.
• Modify the server configuration safely.
• Verify that your changes have been applied.

Before you begin

Requirements

Make sure you have:

• A working MathType Integration Services deployment.
• Access to the MathType Integration Services configuration file.
• Permission to restart your web server or application server if required.

Applies to

Self-hosted MathType Integration Services

Steps

Locate the configuration file

MathType Integration Services store their configuration in a deployment-specific configuration file.

Understand the configuration format

PHP, Java, and Docker deployments use an INI-style configuration file. Lines beginning with # are treated as comments and ignored by Integration Services. Each setting consists of a key-value pair:

parameter = value

For .NET deployments, the configuration is stored in the standard Web.config file.

Understand configuration precedence

The Integration Services configuration file defines the default behaviour for every frontend integration connected to the same deployment.

Some settings can also be configured by the frontend integration or by editor-specific parameters. When both server-side and frontend configuration are available, the frontend configuration takes precedence for that integration, while the Integration Services configuration remains the global default.

This allows multiple integrations to share the same Integration Services deployment while applying different frontend settings when needed.

Edit the configuration

Open the configuration file and modify the parameters required for your deployment. Depending on what you want to configure, continue with one of the following guides:

• Configure frontend service endpoints.
• Configure rendering output.
• Configure formula storage and cache.
• Configure proxy and network settings.
• Configure cross-domain requests.

For a complete description of every supported parameter, see MathType Integration Services parameters.

Apply the changes

Save the configuration file. Depending on your deployment, configuration changes may require restarting the service.

Verify the configuration

Verify that the configuration endpoint returns the expected configuration.

Verify it worked

If you modified rendering, storage, networking, or other processing options, perform a complete integration test:

1. Open your HTML editor.
2. Insert a formula.
3. Save the content.
4. Reload the page.
5. Reopen the formula for editing.
6. Verify that the expected behaviour is applied.

Common issues

Configuration changes are not applied

Verify that:

• You edited the correct configuration file for your deployment.
• The configuration file contains valid syntax.
• The service has been restarted if required by your deployment.

The configuration file cannot be found

Verify that:

• You're looking in the correct location for your deployment.
• The configuration.ini file has been created from configuration.ini.dist, if required.
• Your deployment was installed correctly.

Related articles

• Configure frontend service endpoints.
• Configure rendering output.
• Configure formula storage and cache.
• Configure proxy and network settings.
• Configure cross-domain requests.
• MathType Integration Services parameters.