Skip to content


Subversion checkout URL

You can clone with
Download ZIP

Getting Started

Bruce Yinhe edited this page · 12 revisions

YCSB is a framework for benchmarking systems. By itself, it is not particularly useful; only when you add code to interface with a data serving system is it useful. The current YCSB release (0.2.0) contains code to interface with the following systems:

It is straightforward to interface with other database systems - see Adding a Database.

1. Obtain YCSB

If you'll be running on Windows, please start by referencing our prerequisites for Windows.

Download the latest version:

curl -O --location
tar xfvz ycsb-0.3.0.tar.gz
cd ycsb-0.3.0

Or clone the git repository and build:

git clone git://
mvn clean package

Systems may have additional requirements for running clients. For example, HBase requires the client be able to contact Zookeeper. See HBase 0.20.3 Client Package Description for HBase-specific instructions. Some details are listed in Using the Database Libraries.

You will be using the ycsb command to interact with YCSB. Run:


to see the usage.

2. Now, run a workload

See Running a Workload.

Something went wrong with that request. Please try again.