Installing on
Debian and Ubuntu

Riak KV can be installed on Debian or Ubuntu-based systems using a binary package or by compiling from source code.

The following steps have been tested to work with Riak KV on:

  • Ubuntu 18.02
  • Ubuntu 16.04
  • Ubuntu 14.04
  • Ubuntu 12.04
  • Debian 9.2
  • Debian 8.6
  • Debian 7.6
  • Raspbian Buster

Note on Debian 7

If you wish to install Riak on Debian 7, you may need to install libc6 version 2.15 or later, which in turn requires upgrading your system to sid. Installation instructions can be found here.

Once sid has been installed, you can install libc6 with the following command:

apt-get -t sid install libc6 libc6-dev libc6-dbg

Installing From Package

If you wish to install the deb packages by hand, follow these instructions.

Installing on Non-LTS Ubuntu Releases

Typically we only package Riak for LTS releases to keep our build and testing matrix focused. In some cases, such as the historic Ubuntu 11.04 (Natty), there are changes that affect how Riak is packaged, so we will release a separate package for that non-LTS release. In most other cases, however, if you are running a non-LTS release (such as 12.10) it is safe to follow the below instructions for the LTS release prior to your release. In the case of later subversions such as Ubuntu 12.10, follow the installation instructions for Ubuntu 12.04.

PAM Library Requirement for Ubuntu

One dependency that may be missing on your machine is the libpam0g-dev package used for Pluggable Authentication Module (PAM) authentication, associated with Riak security.

To install:

sudo apt-get install libpam0g-dev

SSL Library Requirement for Ubuntu and Debian

Riak currently requires libssl version 0.9.8 on some versions of Ubuntu. Starting at Ubuntu 12.04 this is no longer an issue. Before installing Riak via package on Ubuntu, install the libssl0.9.8 package. Note that this version of libssl can be safely installed alongside current/existing libssl installations.

To install the libssl version 0.9.8 package, execute the following command:

sudo apt-get install libssl0.9.8

After the libssl package installation, proceed to installing Riak from the pre-built package by executing the following commands as appropriate for the target platform:

Riak 64-bit Installation

Ubuntu Bionic Beaver (18.04)

wget https://files.tiot.jp/riak/kv/2.2/2.2.6/ubuntu/bionic64/riak_2.2.6-1_amd64.deb
sudo dpkg -i riak_2.2.6-1_amd64.deb

Ubuntu Xenial Xerus (16.04)

wget https://files.tiot.jp/riak/kv/2.2/2.2.6/ubuntu/xenial64/riak_2.2.6-1_amd64.deb
sudo dpkg -i riak_2.2.6-1_amd64.deb

Ubuntu Trusty Tahr (14.04)

wget https://files.tiot.jp/riak/kv/2.2/2.2.6/ubuntu/trusty64/riak_2.2.6-1_amd64.deb
sudo dpkg -i riak_2.2.6-1_amd64.deb

Ubuntu Precise Pangolin (12.04)

wget https://files.tiot.jp/riak/kv/2.2/2.2.6/ubuntu/precise64/riak_2.2.6-1_amd64.deb
sudo dpkg -i riak_2.2.6-1_amd64.deb

Debian Stretch (9.0)

wget https://files.tiot.jp/riak/kv/2.2/2.2.6/debian/9/riak_2.2.6-1_amd64.deb
sudo dpkg -i riak_2.2.6-1_amd64.deb

Debian Jessie (8.0)

wget https://files.tiot.jp/riak/kv/2.2/2.2.6/debian/8/riak_2.2.6-1_amd64.deb
sudo dpkg -i riak_2.2.6-1_amd64.deb

Debian Wheezy (7.0)

wget https://files.tiot.jp/riak/kv/2.2/2.2.6/debian/7/riak_2.2.6-1_amd64.deb
sudo dpkg -i riak_2.2.6-1_amd64.deb

Raspbian Buster

wget https://files.tiot.jp/riak/kv/2.2/2.2.6/raspbian/buster/riak_2.2.6-1_armhf.deb
sudo dpkg -i riak_2.2.6-1_amd64.deb

Installing From Source

First, install Riak dependencies using apt:

sudo apt-get install build-essential libc6-dev-i386 git

Riak requires an Erlang installation. Instructions can be found in Installing Erlang.

wget https://files.tiot.jp/riak/kv/2.2/2.2.6/riak-2.2.6.tar.gz
tar zxvf riak-2.2.6.tar.gz
cd riak-2.2.6
make rel

If the build was successful, a fresh build of Riak will exist in the rel/riak directory.

Next Steps

Now that Riak is installed, check out Verifying a Riak Installation.