Powered by Zoomin Software. For more details please contactZoomin

Install MarkLogic Server

Table of Contents

Installing MarkLogic Server

Save PDF
Save selected topicSave selected topic and subtopicsSave all topics
Share
Share to emailCopy topic URL
Print
  • Last Updated: April 21, 2026
  • 4 minute read
    • MarkLogic Server
    • Version 11.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 11 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 11 download page.

  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 2

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 11 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. Required for Amazon Linux 2 installation: As the root user, create a symbolic link with this command:

    sudo ln -s system-lsb /etc/redhat-lsb

  5. 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-11.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-11.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 (for example, MarkLogicConverters-11.0.0-rhel.x86_64.rpm​) from MarkLogic 11 download page to /tmp or another location.

  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-11.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-11.0.0-rhel.x86_64.rpm​

Mac OS X

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

  2. Download the MarkLogic Server OS X disk image from the MarkLogic 11 download page to your machine, accepting the license agreement when prompted, and saving the file where desired.

  3. Double-click the downloaded .dmg file (for example, MarkLogic-11.0.0-x86_64.dmg) to open the folder that contains the .pkg installer (for example, MarkLogic-11.0.0-x86_64.pkg).

  4. Double-click the installer then follow the wizard to install MarkLogic Server.

  5. When the Installation Summary window appears, click Close.

Note:

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

  1. Download the Filters for OS X disk image from the MarkLogic 11 download page to your machine.

  2. Double-click the downloaded .dmg file (for example, MarkLogicConverters-11.0.0-x86_64.dmg) to open the folder that contains the .pkg installer (for example, MarkLogicConverters-11.0.0-x86_64.pkg).

  3. Double-click the installer then follow the wizard to install MarkLogic Server.

  4. When the Installation Summary window appears, click Close.

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

Mac OS X

~/Library/MarkLogic

~/Library/Application Support/MarkLogic/Data

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

Mac OS X

~/Library/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