Welcome to Synnefo’s documentation

Synnefo is open source cloud software, used to create massively scalable IaaS clouds.
Synnefo uses Google Ganeti for the low level VM management part.
You can see Synnefo in action, powering GRNET’s ~okeanos public cloud service.
It is a collection of components (snf-*), most of them written in python, that are used as the building bricks to provide the following services:

There are also the following tools:

Synnefo is designed to be as simple, scalable and production ready as possible. Furthermore, although it can be deployed in small configurations, its prime target is large installations.

All Synnefo components use an intuitive settings mechanism, that adds and removes settings dynamically as components are getting added or removed from a physical node. All settings are stored in a single location.

Synnefo General Architecture

The following graph shows the whole Synnefo architecture and how it interacts with multiple Ganeti clusters.


Synnefo also supports RADOS as an alternative storage backend for Files/Images/VM disks. Here is a graph that shows Synnefo running with two different storage backends.

Synnefo Guides

There are 3 guides for Synnefo.

The quick installation guide describes how to install the whole Synnefo stack in just two physical nodes, for testing purposes. This guide is useful to those interested in deploying Synnefo in large scale, as a starting point that will help them get familiar with the Synnefo components and overall architecture, as well as the interconnection between different services. Such an installation, also provides a quick preview of the basic Synnefo features, although we like to think that Synnefo’s real power unveils while scaling.

The Administrator’s Guide targets system administrators, who want to dive into more details and common tasks regarding Synnefo. For the experienced Synnefo administrator, there is also a section that describes how to do scale-out Synnefo deployments with corresponding examples. This targets large scale installations of Synnefo.

The Developer’s Guide targets developers, who want to build on top of Synnefo and so describes all the different types of interfaces Synnefo provides to the external world. Also documents all Synnefo external REST APIs.


You can contact the Synnefo team at the following mailing lists:

The official site is:

Indices and tables