Skip to content
Get your data in RAM. Get compute close to data. Enjoy the performance.
C C++ Lua CMake Python Ragel in Ruby Host Other
Latest commit 2df2711 @kostja kostja gh-1298: (performance regression in small allocator)
Update the server to use a fixed libsmall
Failed to load latest commit information.
FreeBSD/databases/tarantool Upgrade FreeBSD port files
cmake CMake: fix order of ENABLE_BACKTRACE and compiler.cmake
debian Debian: bring back setgid bit on /var/log/tarantool
doc Merge remote-tracking branch 'origin/master' into 1.6
extra Fix #1293: Permission denied on tarantoolctl enter
rpm Disable tests for CentOS 6
src gh-1298: (performance regression in small allocator)
test-run @ 8797cb1 Drop python-daemon dependency
test Merge remote-tracking branch 'origin/fix-gh-1323-index-count-works-to…
third_party If libev uses eventfd instead of pipe then evpipe[0] can be -1.
.appveyor.yml windows: add .appveyor.yml to enable Appveyor CI
.gdbinit Initial public import
.gitignore Fix .gitignore for `tar --exclude-vcs-ignores`
.gitmodules Ignore dirty files in submodules
.travis.yml Update the list of supported OS for tarantool/build
AUTHORS Update copyright.
CMakeLists.txt CMake: fix order of ENABLE_BACKTRACE and compiler.cmake
Doxyfile Fix #1020: Build warnings when building public C API manual Move module.h to src/
LICENSE Update copyright.
README.CentOS instead of RelWithDebugInfo should be used RelWithDebInfo
README.FreeBSD Update README.FreeBSD: no need to use GCC any more
README.MacOSX Update homebrew building instructions Drop python-daemon dependency gh-1262: document coredumpctl(1) usage
TODO Move away from launchpad bugs in the manual, web site comments, crash… Tarantool cloud build

tarantool Build Status


Tarantool is an in-memory database and application server.

Key features of the application server:

  • 100% compatible drop-in replacement for Lua 5.1, based on LuaJIT 2.0. Simply use #!/usr/bin/tarantool instead of #!/usr/bin/lua in your script.
  • full support for Lua modules and a rich set of own modules, including cooperative multitasking, non-blocking I/O, access to external databases, etc

Key features of the database:

  • MsgPack data format and MsgPack based client-server protocol
  • two data engines: 100% in-memory with optional persistence and a 2-level disk-based B-tree, to use with large data sets
  • multiple index types: HASH, TREE, BITSET
  • asynchronous master-master replication
  • authentication and access control
  • the database is just a C extension to the app server and can be turned off

Supported platforms are Linux/x86 and FreeBSD/x86, Mac OS X.

Tarantool is ideal for data-enriched components of scalable Web architecture: queue servers, caches, stateful Web applications.

Compilation and install

Tarantool is written in C and C++. To build, you will need GCC or Apple CLang compiler.

CMake is used for configuration management. 3 standard CMake build types are supported:

  • Debug -- used by project maintainers
  • RelWithDebInfo -- the most common release configuration, also provides debugging capabilities
  • Release -- use only if the highest performance is required

The build depends on the following external libraries:

  • libreadline and libreadline-dev
  • GNU bfd (part of GNU binutils).

Please follow these steps to compile Tarantool:

# If compiling from git
tarantool $ git submodule update --init --recursive

tarantool $ cmake .
tarantool $ make

To use a different release type, say, RelWithDebInfo, use:

tarantool $ cmake . -DCMAKE_BUILD_TYPE=RelWithDebInfo

Additional build options can be set similarly:

tarantool $ cmake . -DCMAKE_BUILD_TYPE=RelWithDebInfo -DENABLE_DOC=true # builds the docs

'make' creates 'tarantool' executable in directory src/.

There is 'make install' goal. One can also run Tarantool executable without installation.

To start the server, try:

tarantool $ ./src/tarantool

This will start Tarantool in interactive mode.

To run Tarantool regression tests (test/, a few additional Python modules are necessary:

  • PyYAML==3.10
  • argparse==1.1
  • msgpack-python==0.4.6
  • gevent==1.1b5
  • six>=1.8.0

Or run:

pip install -r test-run/requirements.txt

Simply type 'make test' to fire off the test coverage.

Please report bugs at We also warmly welcome your feedback in the discussion mailing list,

Thank you for your interest in Tarantool!

Something went wrong with that request. Please try again.