Powered by Zoomin Software. For more details please contactZoomin

Install MarkLogic Server

Installing MarkLogic Server

  • Last Updated: April 21, 2026
  • 3 minute read
    • MarkLogic Server
    • Version 12.0
    • Documentation

This section describes the procedure for installing MarkLogic Server on each platform. Follow the steps corresponding to the platform to which you are installing.

Platform

Steps

Windows x64

  1. If you are upgrading from a previous MarkLogic Server release, then review Upgrading from Previous Releases and perform the necessary steps from that section first.

  2. Download the MarkLogic Server installation package from the MarkLogic 12 download page.

  3. Double-click the .msi file to start the installer.

  4. The Welcome page appears. Click Next.

  5. Select Typical.

  6. Click Install.

  7. A dialog appears with the question Do you want to allow this app to make changes to your device? Click Yes.

  8. The installation process begins. When the process is completed, click Finish.

Note:

To install the MarkLogic Converters package, also follow these steps:

  1. Download the MarkLogic Converters package (.msi) for Windows from the MarkLogic 12 download page by clicking Filters for Microsoft Windows.

  2. Double-click the .msi file to start the installer.

  3. The Welcome page appears: Welcome to the MarkLogic Converters Setup Wizard. Click Next.

  4. The Choose Setup Type page appears. Select Typical.

  5. The Ready to Install page appears. Click Install to start the installation.

  6. A dialog appears with the question Do you want to allow this app to make changes to your device? Click Yes.

  7. The Installing MarkLogic Converters page appears.

  8. The final page appears: Completing the MarkLogic Converters Setup Wizard. Click Finish.

Red Hat Linux x64

Amazon Linux 2023

  1. If you are upgrading from a previous MarkLogic Server release, then review Upgrading from Previous Releases and perform the necessary steps from that section first.

  2. Download the MarkLogic Server installation package from the MarkLogic 12 download page to /tmp or another location.

  3. Required for all Amazon Linux installation: As the root user, load additional packages for EC2 support with this command:

    sudo yum install java-11-openjdk xfsprogs
  4. We recommend that you use yum to install MarkLogic Server instead of an rpm install. The yum install will automatically determine the dependencies. As the root user, install the package with this command:

    yum install /tmp/MarkLogic-12.0.0-rhel.x86_64.rpm

    Tip:

    If a yum installation cannot be completed, then an rpm install can be used. To do an rpm install, as the root user, install the package with this command:

    rpm -i /tmp/MarkLogic-12.0.0-rhel.x86_64.rpm

Note:

To install the MarkLogic Converters package, also follow these steps:

  1. Download the MarkLogic Converters package for the Linux platform to /tmp or another location by clicking Filters for Linux on the MarkLogic 12 download page.

  2. We recommend that you use yum to install MarkLogic Server instead of an rpm install. The yum install will automatically determine the dependencies. As the root user, install the package with this command:

    yum install /tmp/MarkLogicConverters-12.0.0-rhel.x86_64.rpm​

    Tip:

    If a yum installation cannot be completed, then an rpm install can be used. To do an rpm install, as the root user, install the package with this command:

    rpm -i /tmp/MarkLogicConverters-12.0.0-rhel.x86_64.rpm​

If you are upgrading a cluster to a new release, then see Upgrading a Cluster to a New Maintenance Release of MarkLogic Server in Scalability, Availability, and Failover.

Note:

Do not install MarkLogic Converters while MarkLogic Server is running, because MarkLogic Server checks for them only on startup. Stop MarkLogic Server, install or upgrade MarkLogic Server, install MarkLogic Converters, then start MarkLogic Server.

This table shows the installation directory (<marklogic-dir>) and the default data directory for each platform:

Platform

Installation Directory

Default Data Directory

for configuration and log files

Windows

c:\Program Files\MarkLogic\

c:\Program Files\MarkLogic\Data

Red Hat Linux

/opt/MarkLogic

/var/opt/MarkLogic

The default forest directory is the same as the default data directory if the optional data directory is not specified during forest creation. On UNIX platforms, if you want MarkLogic Server to use another location for its default data directory, then make your data directory (/var/opt/MarkLogic on Linux) a soft link to the alternate location.

This table describes the MarkLogic Converters installation directory:

Platform

Converters Installation Directory

Windows

c:\Program Files\MarkLogic\Converters

Red Hat Linux

/opt/MarkLogic/Converters

Note:

When a new node joins an existing cluster, MarkLogic Server does not try to figure out automatically whether the MarkLogic Converters package is needed. An XDMP-CVTNOTFOUND error will be thrown if a built-in function relying on MarkLogic Converters is called on a node that does not have MarkLogic Converters installed.

TitleResults for “How to create a CRG?”Also Available inAlert