Getting Started

Date:November 13, 2014


From debian package

Add the following to your /etc/apt/sources.list:

deb digg-public-lenny main contrib non-free

Update the index and install clusto:

# aptitude update
# aptitude install clusto

Building an rpm package

You may need to install rpmdevtools beforehand, or run the rpmbuild as root:

$ cd rpm/
$ ./
$ rpmbuild -ta clusto-$VERSION.tar.gz

From source

$ git clone git://
$ cd clusto
$ python build

As root:

# python install
# mkdir /etc/clusto /var/lib/clusto
# cp conf/* /etc/clusto/
# cp contrib/* /var/lib/clusto/

You may need to install additional python libraries for certain features of clusto to function properly.


Clusto is built on top of SQLAlchemy and therefore should work with any backend database available to that library. For the same of simplicity, the following documentation assumes you are using a MySQL backend.

Create a MySQL database

# aptitude install mysql-server
# mysql -u root
mysql> CREATE DATABASE clusto;
mysql> GRANT ALL PRIVILEGES ON clusto.* TO 'clustouser'@'localhost' IDENTIFIED BY 'clustopass';


dsn = mysql://clustouser:clustopass@

Creating tables

Using clusto-shell: