# Installing

## With distro package and pypi

This requires librocksdb-dev>=5.0

    apt-get install python-virtualenv python-dev librocksdb-dev
    virtualenv venv
    source venv/bin/activate
    pip install python-rocksdb

## From source

### Building rocksdb

Briefly describes how to build rocksdb under an ordinary debian/ubuntu. For more details consider https://github.com/facebook/rocksdb/blob/master/INSTALL.md

    apt-get install build-essential libsnappy-dev zlib1g-dev libbz2-dev libgflags-dev
    git clone https://github.com/facebook/rocksdb.git
    cd rocksdb
    mkdir build && cd build
    cmake ..
    make

#### Systemwide rocksdb

The following command installs the shared library in `/usr/lib/` and the header files in `/usr/include/rocksdb/`:

    make install-shared INSTALL_PATH=/usr

To uninstall use:

    make uninstall INSTALL_PATH=/usr

#### Local rocksdb

If you don’t like the system wide installation, or you don’t have the permissions, it is possible to set the following environment variables. These varialbes are picked up by the compiler, linker and loader

    export CPLUS_INCLUDE_PATH=${CPLUS_INCLUDE_PATH}:`pwd`/../include
    export LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:`pwd`
    export LIBRARY_PATH=${LIBRARY_PATH}:`pwd`

### Building python-rocksdb

    apt-get install python-virtualenv python-dev
    virtualenv venv
    source venv/bin/activate
    pip install git+git://github.com/NightTsarina/python-rocksdb.git#egg=python-rocksdb