The manual is arranged as a reflection of the most likely way you would use Manticore:

• starting from some basic information about it and how to install and connect
• through some essential things like adding documents and running searches
• to some performance optimization tips and tricks and extending Manticore with help of plugins and custom functions

Key sections of the manual are marked with sign ✔️ in the menu for your convenience since their corresponding functionality is most used. If you are new to Manticore we highly recommend to not skip them.

If you are looking for a quick understanding of how Manticore works in general ⚡ Quick start guide section should be good to read.

Each query example has a little icon 📋 in the top-right corner:

You can use it to copy examples to clipboard. If the query is an HTTP request it will be copied as a CURL command. You can configure the host/port if you press ⚙️.

We love search and we've made our best to make searching in this manual as convenient as possible. Of course it's backed by Manticore Search. Besides using the search bar which requires opening the manual first there is a very easy way to find something by just opening mnt.cr/your-search-keyword :

There are few things you need to understand about Manticore Search that can help you follow the best practices of using it.

• Real-time index allows adding, updating and deleting documents with immediate availability of the changes.
• Plain index is a mostly immutable data structure and a basic element used by real-time indexes. Plain index stores a set of documents, their common dictionary and indexation settings. One real-time index can consist of multiple plain indexes (chunks), but besides that Manticore provides direct access to building plain indexes using tool indexer. It makes sense when your data is mostly immutable, therefore you don't need a real-time index for that.

Manticore Search works in two modes:

• Real-time mode (RT mode). This is a default one and:
  • allows managing your data schema online using SQL commands CREATE/ALTER/DROP TABLE and their equivalents in non-SQL clients
  • in the configuration file you need to define only server-related settings
• Plain mode allows to define your data schemas in a configuration file. It makes sense in two cases:
  • when you only deal with plain indexes
  • or when your data schema is very stable and you don't need replication (as it's available only in the RT mode)

You cannot combine the 2 modes and need to decide which one you want to follow. If you are unsure our recommendation is to follow the RT mode as if even you need a plain index you can build it with a separate plain index config and import to your main Manticore instance.

Real-time indexes can be used in both RT and plain modes. In RT mode an RT index is defined with a CREATE TABLE command, while in plain mode it is defined in the configuration file. Plain (offline) indexes are supported only in the plain mode. Plain indexes cannot be created in the RT mode, but existing plain indexes made in the plain mode can be converted to real-time indexes and imported in the RT mode.

Manticore provides multiple ways and interfaces to manage your schemas and data, but the two main are:

• SQL. This is a native Manticore's language which enables all Manticore's functionality. The best practice is to use SQL to:
  • manage your schemas and do other DBA routines as it's the easiest way to do that
  • design your queries as SQL is much closer to natural language than the JSON DSL which is important when you design something new. You can use Manticore SQL via any MySQL client or /sql.
• JSON. Most functionality is also available via JSON domain specific language. This is especially useful when you integrate Manticore with your application as with JSON you can do it more programmatically than with SQL. The best practice is to first explore how to do something via SQL and then use JSON to integrate it into your application.

Docker images of Manticore Search are publicly available on Docker Hub built from Manticore Search docker GitHub repository.

To fetch Manticore image execute:

docker pull manticoresearch/manticore

See Using Manticore in Docker for more details about using Manticore in Docker.

Supported releases:

• CentOS 6 and RHEL 6
• CentOS 7 and RHEL 7
• CentOS 8 and RHEL 8

Supported platforms:

• x86
• x86_64

The easiest way to install Manticore in RedHat/Centos is by using our YUM repository:

Install the repository:

yum install https://repo.manticoresearch.com/manticore-repo.noarch.rpm

Then install Manticore Search:

yum install manticore

If you prefer "Nightly" (development) versions do:

yum install https://repo.manticoresearch.com/manticore-repo.noarch.rpm
yum --enablerepo manticore-dev install manticore

You can also download individual rpm files from our site and install them using tools rpm or yum.

Apart the package, if you plan to use indexer to create indexes from external sources, you'll need to install corresponding client libraries in order to make available of indexing sources you want. The line below will install all of them at once; feel free to use it as is, or to reduce it to install only libraries you need (for only mysql sources - just mysql-libs should be enough, and unixODBC is not necessary).

yum install mysql-libs postgresql-libs expat unixODBC