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)
  • 20.04 LTS (Focal)

Supported platforms:

• x86
• x86_64

You can install Manticore by adding Manticore's APT repository to your repositories:

apt-key adv --fetch-keys 'https://repo.manticoresearch.com/GPG-KEY-manticore'
wget https://repo.manticoresearch.com/manticore-repo.noarch.deb
dpkg -i manticore-repo.noarch.deb
apt update

and then install Manticore Search with just apt install:

apt install manticore

In case you want to install "Nightly" (development) version:

apt-key adv --fetch-keys 'https://repo.manticoresearch.com/GPG-KEY-manticore'
wget https://repo.manticoresearch.com/manticore-dev-repo.noarch.deb
dpkg -i manticore-dev-repo.noarch.deb
apt update
apt install manticore

You can also download individual .deb files from our site.

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

$ sudo -u manticore indexer
Manticore 3.5.4 13f8d08d@201211 release
Copyright (c) 2001-2016, Andrew Aksyonoff
Copyright (c) 2008-2016, Sphinx Technologies Inc (http://sphinxsearch.com)
Copyright (c) 2017-2020, Manticore Software LTD (http://manticoresearch.com)

Built by gcc/clang v 5.4.0,

Built on Linux runner-0277ea0f-project-3858465-concurrent-0 4.19.78-coreos #1 SMP Mon Oct 14 22:56:39 -00 2019 x86_64 x86_64 x86_64 GNU/Linux

Configured by CMake with these definitions: -DCMAKE_BUILD_TYPE=RelWithDebInfo -DDISTR_BUILD=xenial -DUSE_SSL=ON -DDL_UNIXODBC=1 -DUNIXODBC_LIB=libodbc.so.2 -DDL_EXPAT=1 -DEXPAT_LIB=libexpat.so.1 -DUSE_LIBICONV=1 -DDL_MYSQL=1 -DMYSQL_LIB=libmysqlclient.so.20 -DDL_PGSQL=1 -DPGSQL_LIB=libpq.so.5 -DLOCALDATADIR=/var/data -DFULL_SHARE_DIR=/usr/share/manticore -DUSE_ICU=1 -DUSE_BISON=ON -DUSE_FLEX=ON -DUSE_SYSLOG=1 -DWITH_EXPAT=1 -DWITH_ICONV=ON -DWITH_MYSQL=1 -DWITH_ODBC=ON -DWITH_PGSQL=1 -DWITH_RE2=1 -DWITH_STEMMER=1 -DWITH_ZLIB=ON -DGALERA_SOVERSION=31 -DSYSCONFDIR=/etc/manticoresearch

Here you can see mentions of libodbc.so.2, libexpat.so.1, libmysqlclient.so.20, and libpq.so.5.

Below is a reference table with list of all the client libraries for different Debian/Ubuntu versions:

Distr	MySQL	PostgreSQL	XMLpipe	UnixODBC
Ubuntu Trusy	libmysqlclient.so.18	libpq.so.5	libexpat.so.1	libodbc.so.1
Ubuntu Xenial	libmysqlclient.so.20	libpq.so.5	libexpat.so.1	libodbc.so.2
Ubuntu Bionic	libmysqlclient.so.20	libpq.so.5	libexpat.so.1	libodbc.so.2
Ubuntu Focal	libmysqlclient.so.21	libpq.so.5	libexpat.so.1	libodbc.so.2
Debian Jessie	libmysqlclient.so.18	libpq.so.5	libexpat.so.1	libodbc.so.2
Debian Stretch	libmariadbclient.so.18	libpq.so.5	libexpat.so.1	libodbc.so.2
Debian Buster	libmariadb.so.3	libpq.so.5	libexpat.so.1	libodbc.so.2

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

apt-file find libmysqlclient.so.20
libmysqlclient20: /usr/lib/x86_64-linux-gnu/libmysqlclient.so.20
libmysqlclient20: /usr/lib/x86_64-linux-gnu/libmysqlclient.so.20.2.0
libmysqlclient20: /usr/lib/x86_64-linux-gnu/libmysqlclient.so.20.3.6

Note that you only need libraries for the types of storages you're going to use. So if you plan to index only from mysql then you might need to install only the MySQL library (in the above case libmysqlclient20).

Finally install the needed packages:

sudo apt-get install libmysqlclient20 libodbc1 libpq5 libexpat1

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

To enable CJK tokenization support the official packages contain binaries with embedded ICU library and include ICU data file. They are independent from any ICU runtime library which might be available on your system, and can't be upgraded.

After preparing a configuration file (see Quick start guide), you can start searchd server:

systemctl start manticore

To enable Manticore at boot:

systemctl enable manticore

On MacOS Manticore can be installed in two ways:

Bottles are available for:

• MacOS High Sierra
• MacOS Mojave
• MacOS Catalina

On older versions of MacOS it will attempt to compile from sources automatically.

brew install manticoresearch

For indexing the additional dependencies that can be installed using brew are [email protected], libpq, unixodbc.

Afterwards you can start Manticore as a brew service:

brew services start manticoresearch

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

Download it from the website and unpack to a folder:

mkdir manticore
tar -zxvf 3.5.4-201211-13f8d08d-release-osx10.13.6-x86_64-main.tar.gz -C manticore
cd manticore
bin/searchd  -c manticore.conf

Manticore configuration file manticore.conf is located in the directory, unpacked from the tarball.

To install Manticore in Windows you need to download the zip archive and unpack it into a folder.

In the following example we'll assume we unpack the zip contents to folder C:\Manticore.

cd C:\Manticore
unzip manticore-3.5.4-201211-13f8d08d-release-x64-main.zip

The zip comes with a sample configuration file in sphinx.conf.in. The configuration contains a @CONFDIR@ string which needs to be replaced with your data directory location. It will be the root directory of data and log folders (first is used to store indexes, second for logs). The zip package also 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.

To install the searchd (Manticore search server) as a Windows service run:

C:\Manticore\bin\searchd --install --config C:\Manticore\sphinx.conf.in --servicename Manticore

Make sure to use the full path of the configuration file, otherwise searchd.exe will not be able to know its location 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 command line interface:

mysql -P9306 -h127.0.0.1

Note that in most examples in this manual we use -h0, but in Windows you need to use localhost or 127.0.0.1 for the local host.