Installing Manticore packages on Debian and Ubuntu

Supported releases:

  • Debian

    • 8.0 (jessie)
    • 9.0 (stretch)
    • 10.0 (buster)
  • Ubuntu

    • 14.04 LTS (trusty)
    • 16.04 LTS (xenial)
    • 18.04 LTS (bionic)

Supported platforms:

  • x86
  • x86_64

You can install Manticore with command:

$ wget
$ sudo dpkg -i manticore_2.4.1-171017-3b31a97-release-stemmer.jessie_amd64-bin.deb

Manticore package depends on zlib and ssl libraries, nothing else is strictly required. However if you plan to use ‘indexer’ tool to create indexes from different sources, you’ll need to install appropriate client libraries. To know what exactly libraries, run indexer tool from Manticore and look at the top of it’s output:

$ indexer
Manticore 2.4.1 4258276@171019 id64-beta
Copyright (c) 2001-2016, Andrew Aksyonoff
Copyright (c) 2008-2016, Sphinx Technologies Inc (
Copyright (c) 2017, Manticore Software LTD (

Built by gcc/clang v 6.3.0,

Built on Linux d2a57137d4f5 4.8.0-45-generic #48~16.04.1-Ubuntu SMP Fri Mar 24 12:46:56 UTC 2017 x86_64 GNU/Linux

Here you can see mentions of,,, and

Below is the reference table with list of all client libraries for different debian/ubuntu distributions:

Distr Mysql PostgresQL Xmlpipe Unixodbc

To find the packages which provide the libraries you can use, for example apt-file:

$ apt-file find
libmysqlclient20: /usr/lib/x86_64-linux-gnu/
libmysqlclient20: /usr/lib/x86_64-linux-gnu/
libmysqlclient20: /usr/lib/x86_64-linux-gnu/

Note, that you need only libs for types of sources you’re going to use. So if you plan to make indexes only from mysql source, then install only lib for mysql client (in case above - libmysqlclient20).

Finally install necessary packages:

$ sudo apt-get install libmysqlclient20 libodbc1 libpq5 libexpat1

If you aren’t going to use indexer tool at all, you don’t need find and install any libraries.

Manticore can optionally use the ICU library for chinese morphology processing. The appropriate ICU library used at compiling must be installed for using the ICU processor. Below is the reference table with the ICU library for different debian/ubuntu distributions:

Distr ICU library

For example on Debian Stretch libicu57 needs to be additionally installed for ICU support:

$ sudo apt-get install libicu57

After preparing configuration file (see Quick tour), you can start searchd daemon:

$ systemctl start manticore

To enable Manticore at boot:

$ systemctl enable manticore

Installing Manticore packages on RedHat and CentOS

Supported releases:

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

Supported platforms:

  • x86
  • x86_64

Manticore package depends on zlib and ssl libraries, nothing else is strictly required. However if you plan to use ‘indexer’ tool to create indexes from different sources, you’ll need to install appropriate client libraries. Use yum to download and install these dependencies:

$ yum install mysql-libs postgresql-libs expat unixODBC

Note, that you need only libs for types of sources you’re going to use. So if you plan to make indexes only from mysql source, then installing ‘mysql-libs’ will be enough. If you don’t going to use ‘indexer’ tool at all, you don’t need to install these packages.

For ICU support, additional libicu package needs to be installed.

$ yum install libicu

Download RedHat RPM from Manticore website and install it:

$ wget
$ rpm -Uhv manticore-2.4.1-171017-3b31a97-release-stemmer-rhel7-bin.rpm

After preparing configuration file (see Quick tour), you can start searchd daemon:

$ systemctl start searchd

To enable Manticore at boot:

$ systemctl enable searchd

Installing Manticore on Windows

To install on Windows, you need to download the zip package and unpack it first in a folder.

In the following example we’ll consider folder C:\Manticore where we unpack the zip content.

cd C:\Manticore

The zip comes with 2 sample configurations: and The latter is a stripped-down of comments version of the first.

The configuration contains a @CONFIGDIR@ string which needs to be replaced. The @CONFIGDIR@ is the root directory of data and log folders (first is used as location for indexes, second for logs). The zip package comes with these folders, so they will be available at the location where you unzipped the package. If you want to use a different location, the two folders must be created there.

Install the searchd system as a Windows service:

C:\Manticore\bin> C:\Manticore\bin\searchd --install --config C:\Manticore\ --servicename Manticore

Make sure to use the full path of the configuration file, otherwise searchd.exe will not be able to know the location of it when it’s started as service.

After installation, the service can be started from the Services snap-in of the Microsoft Management Console.

Once started you can access Manticore using the mysql cli:

C:\path\to\mysql> mysql -P9306 -h127.0.0.1

(note that in most example, we use -h0, on Windows you need to use localhost or for the local host.)

Installing Manticore on MacOS

On MacOS Manticore can be installed in 2 easy way:

  1. Use the official tar containing binary executables. Download it from the website and unpack it to a folder:
$ mkdir manticore
$ tar -zxvf manticore-3.1.0-190716-445e806e-release-osx10.14.4-x86_64-bin.tar -C manticore
$ cd manticore
$ bin/searchd  -c sphinx.conf

The sphinx.conf is located in the root folder.

  1. Use official brew tap

Add to brew the official Manticore tap and install Manticore. Bottles are available for sierra and mojave.

$ brew tap  manticoresoftware/tap
$ brew install manticoresearch

For indexing additional dependencies that can be installed using brew are mysql@5.7, libpq, unixodbc.

Start Manticore as brew service:

$ brew services start  manticoresearch

The configuration is located at /usr/local/etc/manticore/sphinx.conf.

Running Manticore Search in a Docker Container

Docker images of Manticore Search are hosted publicly on Docker Hub at

For more information about using Docker, see the Docker Docs.

The searchd daemon runs in nodetach mode inside the container under manticore user. Default configuration includes a simple Real-Time index and listens on the default ports (9306 for SphinxQL, 9312 for SphinxAPI and 9308 for HTTP).

The image comes with MySQL and PostgreSQL client libraries for indexing data from these databases, as well as with the expat library for XML indexing.

Starting a Manticore Search instance in a container

To start a container running the latest release of Manticore Search run:

docker run --name manticore -p 9306:9306 -d manticoresearch/manticore

Operations with utility tools over running daemon can be made with docker exec command. Please note that any indexer command must run under manticore user, otherwise searchd won’t be able to rotate the files:

docker exec -it manticore gosu manticore indexer --all --rotate

To stop the Manticore Search container you can simply do:

docker stop manticore

or (managed stop with no hard-killing):

docker exec -it manticore gosu manticore searchd --stopwait

Please note that any indexed data or configuration change made is lost if the container is stopped. For persistence, you need to mount the configuration and data folders.

Mounting points

The configuration folder inside the image is the usual /etc/sphinxseach. Index files are located at /var/lib/manticore/data and logs at /var/lib/manticore/log. For persistence, mount these points to your local folders.

docker run --name manticore -v /path/to/config/:/etc/sphinxsearch/ -v /path/to/data/:/var/lib/manticore/data -v /path/to/logs/:/var/lib/manticore/log -p 9306:9306 -d manticoresearch/manticore

Compiling Manticore from source

Required tools

  • a working compiler

    • on Linux - GNU gcc (4.7.2 and above) or clang can be used
    • on Windows - Microsoft Visual Studio 2015 and above (community edition is enough)
    • on Mac OS - XCode
  • cmake - used on all plaftorms (version 3.13 or above)

Required libraries/packages on Linux

  • Development version of ssl lib. Usually comes in package named like libssl-dev or openssl-devel.
  • Development version of boost. On debian packages libboost-system-dev and libboost-program-options-dev are enough; on redhat it is boost-devel.

Optional dependencies

  • git, flex, bison - needed if the sources are from cloned repository and not the source tarball
  • development version of MySQL client for MySQL source driver
  • development version of unixODBC for the unixODBC source driver
  • development version of libPQ for the PostgreSQL source driver
  • development version of libexpat for the XMLpipe source driver
  • RE2 (bundled in the source tarball) for regexp_filter feature
  • development version of libicudata for ICU chinese morphology processor
  • lib stemmer (bundled in the source tarball ) for additional language stemmers

General building options

For compiling latest version of Manticore, recommended is checkout the latest code from the github repositiory. Alternative, for compiling a certain version, you can either checked that version from github or use it’s respective source tarball. In last case avoid to use automatic tarballs from github (named there as ‘Source code’), but use provided files as manticore-2.4.1-171017-3b31a97-release.tar.gz. When building from git clone you need packages git, flex, bison. When building from tarball they are not necessary. This requirement may be essential to build on Windows.

$ git clone
$ wget
$ tar zcvf manticore-2.4.1-171017-3b31a97-release.tar.gz

Next step is to configure the building with cmake. Available list of configuration options:

  • CMAKE_BUILD_TYPE - can be Debug , Release , MinSizeRel and RelWithDebInfo (default).

  • SPLIT_SYMBOLS (bool) - specify whenever to create separate files with debugging symbols. In the default build type,RelWithDebInfo, the binaries include the debug symbols. With this option specified, the binaries will be stripped of the debug symbols , which will be put in separate files

  • USE_BISON, USE_FLEX (bool) - enabled by default, specifies whenever to enable bison and flex tools

  • LIBS_BUNDLE - filepath to a folder with different libraries. This is mostly relevant for Windows building

  • WITH_STEMMER (bool) - specifies if the build should include the libstemmer library. The library is searched in several places, starting with

    • libstemmer_c folder in the source directory
    • common system path. Please note that in this case, the linking is dynamic and libstemmer should be available system-wide on the installed systems
    • libstemmer_c.tgz in LIBS_BUNDLE folder.
    • download from snowball project website. This is done by cmake and no additional tool is required
    • NOTE: if you have libstemmer in the system, but still want to use static version, say, to build a binary for a system without such lib, provide WITH_STEMMER_FORCE_STATIC=1 in advance.
  • WITH_RE2 (bool) - specifies if the build should include the RE2 library. The library can be taken from the following locations:

    • in the folder specified by WITH_RE2_ROOT parameters
    • in libre2 folder of the Manticore sources
    • system wide search, while first looking for headers specified by WITH_RE2_INCLUDES folder and the lib files in WITH_RE2_LIBS folder
    • check presence of in the LIBS_BUNDLE folder
    • Download from
    • NOTE: if you have RE2 in the system, but still want to use static version, say, to build a binary for a system without such lib, provide WITH_RE2_FORCE_STATIC=1 in advance.
  • WITH_EXPAT (bool) enabled compiling with libexpat, used XMLpipe source driver

  • WITH_MYSQL (bool) enabled compiling with MySQL client library, used by MySQL source driver. Additional parameters WITH_MYSQL_ROOT, WITH_MYSQL_LIBS and WITH_MYSQL_INCLUDES can be used for custom MySQL files

  • WITH_ODBC (bool) enabled compiling with ODBC client library, used by ODBC source driver

  • WITH_PGSQL (bool) enabled compiling with PostgreSQL client library, used by PostgreSQL source driver

  • WITH_ICU (bool) enabled compiling with ICU library support, used by morphology processor

  • DISTR_BUILD - in case the target is packaging, it specifies the target operating system. Supported values are: centos6, centos7, wheezy, jessie, stretch, buster, trusty, xenial, bionic, macos, default.

Compiling on Linux systems

To install all dependencies on Debian/Ubuntu:

$ apt-get install build-essential cmake unixodbc-dev libpq-dev libexpat-dev libmysqlclient-dev libicu-dev libssl-dev libboost-system-dev libboost-program-options-dev git flex bison

Note: on Debian 9 (stretch) package libmysqlclient-dev is absent. Use default-libmysqlclient-dev there instead.

To install all dependencies on CentOS/RHEL:

$ yum install gcc gcc-c++ make cmake mysql-devel expat-devel postgresql-devel unixODBC-devel libicu-devel openssl-devel boost-devel rpm-build systemd-units  git flex bison

(git, flex, bison doesn’t necessary if you build from tarball)

RHEL/CentOS 6 ship with a old version of the gcc compiler, which doesn’t support -std=c++11 flag, for compiling use devtools repository:

$ wget -O /etc/yum.repos.d/devtools-2.repo
$ yum upgrade -y
$ yum install -y devtoolset-2-gcc devtoolset-2-binutils devtoolset-2-gcc-c++
$ export PATH=/opt/rh/devtoolset-2/root/usr/bin:$PATH

Manticore uses cmake for building. We recommend to use a folder outside the sources to keep them clean.

$ mkdir build
$ cd build
$ cmake3 -D WITH_MYSQL=1 -DWITH_RE2=1 ../manticore

or if we use sources from tarball:

$ cmake3 -D WITH_MYSQL=1 -DWITH_RE2=1 ../manticore-2.4.1-171017-3b31a97-release

To simply compile:

$ make -j4

This will create the binary files, however we want to either install Manticore or more convenient to create a package. To install just do

$ make -j4 install

For packaging use package

$ make -j4 package

By default, if no operating system was targeted, package will create only a zip with the binaries. If, for example, we want to create a deb package for Debian Jessie, we need to specify to cmake the DISTR_BUILD parameter:

$ cmake3 -DDISTR_BUILD=jessie ../manticore
$ make -j4 package

This will create 2 deb packages, a manticore-x.x.x-bin.deb and a manticore-x.x.x-dbg.deb which contains the version with debug symbols. Another possible target is tarball , which create a tar.gz file from the sources.

Compiling on Windows

For building on Windows you need:

  • Visual Studio
  • Cmake for Windows
  • Expat, MySQL and PostgreSQL in bundle directory.

If you build from git clone, you also need to provide git, flex, bison tools. They may be fond in cygwin framework. When building from tarball these tools are not necessary.

For a simple building on x64:

C:\build>"%PROGRAMW6432%\CMake\bin\cmake.exe" -G "Visual Studio 14 Win64" -DLIBS_BUNDLE="C:\bundle" "C:\manticore"
C:\build>"%PROGRAMW6432%\CMake\bin\cmake.exe" -DWITH_PGSQL=1 -DWITH_RE2=1 -DWITH_STEMMER=1 .
C:\build>"%PROGRAMW6432%\CMake\bin\cmake.exe" --build . --target package --config RelWithDebInfo

Compiling on FreeBSD


Support for FreeBSD is limited and successful compiling is not guaranteed. We recommend checking the issue tracker for unresolved issues on this platform before trying to compile latest versions.

FreeBSD uses clang instead of gcc as system compiler and it’s installed by default.

First install required packages:

$ pkg install cmake bison flex

To compile a version without optional dependencies:

$ cmake -DUSE_GALERA=0 -DWITH_MYSQL=0 -DDISABLE_TESTING=1 ../manticoresearch/
$ make

With the exception of Galera, the rest of optional dependencies can be installed:

$ pkg install mariadb103-client postgresql-libpqxx unixODBC icu expat

(you can replace mariadb103-client with MySQL client package of your choice)

Building with all optional features and installation system-wide:

$ make
$ make install

Recompilation (update)

If you didn’t change path for sources and build, just move to you build folder and run:

cmake3 .
make clean

If by any reason it doesn’t work, you can delete file CMakeCache.txt located in build folder. After this step you have to run cmake again, pointing to source folder and configuring the options.

If it also doesn’t help, just wipe out your build folder and begin clean compiling from sources

Quick Manticore usage tour

We are going to use SphinxQL protocol as it’s the current recommended way and it’s also easy to play with. First we connect to Manticore with the normal MySQL client:

$ mysql -h0 -P9306

The default configuration comes with a sample Real-Time. A first step to see it in action is to add several documents to it, then you can start perform searches:

mysql> INSERT INTO rt VALUES (1, 'this is', 'a sample text', 11);
    Query OK, 1 row affected (0.00 sec)

mysql> INSERT INTO rt VALUES (2, 'some more', 'text here', 22);
    Query OK, 1 row affected (0.00 sec)

    mysql> INSERT INTO rt VALUES (3, 'more about this text', 'can be found in this text', 22);
    Query OK, 1 row affected (0.00 sec)
mysql> SELECT *,weight() FROM rt  WHERE MATCH('text') ORDER BY WEIGHT() DESC;
    | id   | gid  | weight() |
    |    3 |   22 |     2252 |
    |    1 |   11 |     1319 |
    |    2 |   22 |     1319 |
    3 rows in set (0.00 sec)

In the sample configuration there is also a plain index with MySQL source, which needs to be indexed first in order to start using it. First, we populate the sample table in MySQL:

mysql> create database test;
$ mysql -u test <  /usr/share/doc/manticore/example-conf/example.sql

The sample config uses a test with no password for connecting to MySQL. Adjust the credentials, then index:

$ sudo -u manticore indexer -c /etc/sphinxsearch/sphinx.conf test1 --rotate
Manticore 2.3.3 9b7033e@170806 master...origin/master-id64-dev
Copyright (c) 2001-2016, Andrew Aksyonoff
Copyright (c) 2008-2016, Sphinx Technologies Inc (
Copyright (c) 2017, Manticore Software LTD (

using config file '/etc/sphinxsearch/sphinx.conf'...
indexing index 'test1'...
collected 4 docs, 0.0 MB
sorted 0.0 Mhits, 100.0% done
total 4 docs, 193 bytes
total 0.002 sec, 81503 bytes/sec, 1689.18 docs/sec
total 4 reads, 0.000 sec, 8.1 kb/call avg, 0.0 msec/call avg
total 12 writes, 0.000 sec, 0.1 kb/call avg, 0.0 msec/call avg
rotating indices: successfully sent SIGHUP to searchd (pid=2947).

Now let’s run several queries:

mysql> SELECT *, WEIGHT() FROM test1 WHERE MATCH('"document one"/1');SHOW META;
| id   | group_id | date_added | weight() |
|    1 |        1 | 1502280778 |     2663 |
|    2 |        1 | 1502280778 |     1528 |
2 rows in set (0.00 sec)

| Variable_name | Value    |
| total         | 2        |
| total_found   | 2        |
| time          | 0.000    |
| keyword[0]    | document |
| docs[0]       | 2        |
| hits[0]       | 2        |
| keyword[1]    | one      |
| docs[1]       | 1        |
| hits[1]       | 2        |
9 rows in set (0.00 sec)
mysql>  SET profiling=1;SELECT * FROM test1 WHERE id IN (1,2,4);SHOW PROFILE;
Query OK, 0 rows affected (0.00 sec)

| id   | group_id | date_added |
|    1 |        1 | 1502280778 |
|    2 |        1 | 1502280778 |
|    4 |        2 | 1502280778 |
3 rows in set (0.00 sec)

| Status       | Duration | Switches | Percent |
| unknown      | 0.000059 | 4        | 44.70   |
| net_read     | 0.000001 | 1        | 0.76    |
| local_search | 0.000042 | 1        | 31.82   |
| sql_parse    | 0.000012 | 1        | 9.09    |
| fullscan     | 0.000001 | 1        | 0.76    |
| finalize     | 0.000007 | 1        | 5.30    |
| aggregate    | 0.000006 | 2        | 4.55    |
| net_write    | 0.000004 | 1        | 3.03    |
| eval_post    | 0.000000 | 1        | 0.00    |
| total        | 0.000132 | 13       | 0       |
10 rows in set (0.00 sec)
mysql> SELECT id, id%3 idd FROM test1 WHERE MATCH('this is | nothing') GROUP BY idd;SHOW PROFILE;
| id   | idd  |
|    1 |    1 |
|    2 |    2 |
|    3 |    0 |
3 rows in set (0.00 sec)

| Status | Duration | Switches | Percent |
| total  | 0.000000 | 0        | 0       |
1 row in set (0.00 sec)
mysql> SELECT id FROM test1 WHERE MATCH('is this a good plan?');SHOW PLAN\G
Empty set (0.00 sec)

*************************** 1. row ***************************
Variable: transformed_tree
        Value: AND(
        AND(KEYWORD(is, querypos=1)),
        AND(KEYWORD(this, querypos=2)),
        AND(KEYWORD(a, querypos=3)),
        AND(KEYWORD(good, querypos=4)),
        AND(KEYWORD(plan, querypos=5)))
1 row in set (0.00 sec)
mysql>  SELECT COUNT(*) c, id%3 idd FROM test1 GROUP BY idd HAVING COUNT(*)>1;
    | c    | idd  |
    |    2 |    1 |
    1 row in set (0.00 sec)
mysql>  SELECT COUNT(*) FROM test1;
    | count(*) |
    |        4 |
    1 row in set (0.00 sec)
mysql>   CALL KEYWORDS ('one two three', 'test1', 1);
| qpos | tokenized | normalized | docs | hits |
| 1    | one       | one        | 1    | 2    |
| 2    | two       | two        | 1    | 2    |
| 3    | three     | three      | 0    | 0    |
3 rows in set (0.00 sec)