Product tutorials, how-tos, and fully-documented APIs.

Installing on Mac OS X

    The following steps are known to work with Mac OS X 10.5 and 10.6. You can install from source or download a precompiled tarball.

    Install Types

    ulimit on OS X
    OS X gives you a very small limit on open file handles, so even with a backend that uses very few file handles, it’s possible to run out. See Open Files Limit for more information about changing the limit.

    From Precompiled Tarballs

    To run Riak from our precompiled tarball, run these commands for the appropriate platform:

    64-bit

    curl -O http://s3.amazonaws.com/downloads.basho.com/riak/1.3/1.3.1/osx/10.6/riak-1.3.1-osx-x86_64.tar.gz
tar xzvf riak-1.3.1-osx-x86_64.tar.gz

    32-bit

    curl -O http://s3.amazonaws.com/downloads.basho.com/riak/1.3/1.3.1/osx/10.6/riak-1.3.1-osx-i386.tar.gz
tar xzvf riak-1.3.1-osx-i386.tar.gz

    After the release is untarred you will be able to cd into the riak directory and execute bin/riak start to start the Riak node.

    Homebrew

    Homebrew’s Riak recipe is community supported, and thus is not always up to date with the latest Riak package. Please ensure that the current recipe is using the latest supported code (and don’t be scared to update if it’s not).

    Installing with Homebrew is easy:

    brew install riak

    Homebrew will install Erlang if you don't have it already.

    From Source

    You must have Xcode tools installed from the CD that came with your Mac or from Apple's Developer website.

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

    Riak requires Erlang R15B01. Note: don't use Erlang version R15B02 or R15B03, for the moment, as it causes an error with riak-admin status commands.

    If you do not have Erlang already installed, see Installing Erlang. Don't worry, it's easy!

    Next, download and unpack the source distribution.

    wget http://downloads.basho.com.s3-website-us-east-1.amazonaws.com/riak/1.3/1.3.0/riak-1.3.0.tar.gz
tar zxvf riak-1.3.1.tar.gz
cd riak-1.3.1
make rel

    If you get errors when building about “incompatible architecture”, please verify that you built Erlang with the same architecture as your system (Snow Leopard and higher - 64bit, everything else - 32bit).

    Next Steps?

    From here you might want to check out: