+README
+======
+
+Pithos is a file storage service, built by GRNET using Django (https://www.djangoproject.com/).
+Learn more about Pithos at: http://code.grnet.gr/projects/pithos
+
+Consult COPYRIGHT for licensing information.
+
+About Pithos application
+------------------------
+
+This package contains the Django application that implements the Pithos v2 API. It depends on the Pithos backend, which does the actual data and metadata operations.
+
+How to run
+----------
+
+Use snf-webproject to run Pithos automatically.
+
+To use Pithos in a custom Django project, just add ``pithos.api`` to ``INSTALLED_APPS``.
+
+Settings
+--------
+
+Configure in ``settings.py`` or a ``.conf`` file in ``/etc/synnefo`` if using snf-webproject.
+
+=============================== ================================================ ============================================================
+Name Default value Description
+=============================== ================================================ ============================================================
+PITHOS_AUTHENTICATION_URL \http://127.0.0.1:8000/im/authenticate Astakos API URL
+PITHOS_AUTHENTICATION_USERS A dictionary of sample users (token to username) Set to empty or None to disable
+PITHOS_BACKEND_DB_MODULE pithos.backends.lib.sqlalchemy
+PITHOS_BACKEND_DB_CONNECTION sqlite:////tmp/pithos-backend.db SQLAlchemy database connection string
+PITHOS_BACKEND_BLOCK_MODULE pithos.backends.lib.hashfiler
+PITHOS_BACKEND_BLOCK_PATH /tmp/pithos-data/ Map and block storage path
+PITHOS_BACKEND_QUEUE_MODULE None Use ``pithos.backends.lib.rabbitmq`` to enable
+PITHOS_BACKEND_QUEUE_CONNECTION None Format like ``rabbitmq://guest:guest@localhost:5672/pithos``
+PITHOS_BACKEND_QUOTA 50 GB (50 * 1024 ** 3) Default user quota
+PITHOS_BACKEND_VERSIONING auto Default versioning policy for containers
+=============================== ================================================ ============================================================
+
+Administrator functions
+-----------------------
+
+Available as extensions to Django's command-line management utility:
+
+============ ======================
+Name Description
+============ ======================
+storagequota Get/set a user's quota
+============ ======================
+