Installing from Source

If there isn’t a package for your OS or you are interested in contributing back to the project, you can install Riak TS from source!



To install Riak TS, you will need to have Erlang installed. We strongly recommend using Riak’s patched version of Erlang to install Riak TS. All of the patches in this version have been incorporated into later versions of the official Erlang/OTP release.

See Installing Erlang for instructions.


Riak TS depends on source code located in multiple Git repositories. Install Git on the target system before attempting the build.


Riak TS will not compile with Clang. Please make sure your default C/C++ compiler is GCC.


The following instructions generate a complete, self-contained build of Riak TS in »Unpacked or Cloned Source«/rel/riak.

Installing from source package

Download the Riak TS source package from Downloads and build:

curl -O
tar zxvf riak_ts-1.4.0.tar.gz
cd riak_ts-1.4.0
make locked-deps
make rel

Installing from GitHub

To clone and build Riak TS from source, clone the repository using Git and build:

git clone --branch riak_ts-1.4.0
cd riak_ts-1.4.0
make locked-deps
make rel

Verify Your Installation

You can verify that Riak TS was successfully installed by running riak shell:

sudo riak-shell

Verify your connection by running show_connection:


You should see a reply like this one:

riak_shell is connected to: 'dev1@' on port 8087

Make sure to exit riak shell when you are done by running q;.

Start your Riak TS node

Once you’ve successfully installed Riak TS, start it on your node:

riak start

Verify Riak TS is running

You can verify that Riak TS is started and ready to use by pinging it.

riak ping

If Riak TS has started, you will receive a pong response. If it has not started, you will receive an error.

Next Steps

Now that you’ve installed Riak TS, check out Planning Your Riak TS Table.