Installing from Source

Get the latest docs
You are looking at documentation for an older release. Not what you want? Go to the current release documentation.

Installing Cloudify from sources is possible from PyPi and GitHub.

Advanced Section

This method of installation is intended for advanced users or developers.

Installation from sources requires an environment with compilers installed and configured since some of Cloudify’s dependencies are not pure Python modules.

Familiarity with Virtualenv and Pip is recommended as well.

Install inside Virtualenv

It is recommended to install all of the components below in a virtualenv in order to avoid polluting the global Python environment on your system and to remove the requirement for root permissions on some of the systems.

Installation Prerequisites

For all users the following components are required:

For Windows users

Microsoft Visual C++ Compiler for Python 2.7

For Linux users

The following should be available in your OS package repository:

Python header files (python-dev in Ubuntu/Debian or python-devel in CentOS/RHEL)
GNU C compiler (gcc)

For OS X users

Xcode Command Line Tools

Installing from PyPi

PyPi is the official repository for 3rd party Python modules. Cloudify uploads its Python artifacts to PyPi.

Installing the latest release from PyPi is done by running the following commands in a terminal:

  
$ pip install cloudify

It’s also possible to request a specific version:

  
$ pip install cloudify==3.3

PyPi contains the same releases that you can find on GitHub, however naming convention is a bit different, for example, to get 3.3m6 you’ll need to request cloudify==3.3a6.

Full list of PyPi versions is available here.

Installing from GitHub

Cloudify uses GitHub as its main online source code repository.

Installing the latest stable version from GitHub can be done by running the following commands in a terminal:

  
$ CFY_VERSION="3.4.1"
$ pip install "https://github.com/cloudify-cosmo/cloudify-cli/archive/$CFY_VERSION.zip" \
  --requirement "https://raw.githubusercontent.com/cloudify-cosmo/cloudify-cli/$CFY_VERSION/dev-requirements.txt"

Installing latest bleeding edge release can be done in the similar manner:

  
$ CFY_VERSION="master"
$ pip install "https://github.com/cloudify-cosmo/cloudify-cli/archive/$CFY_VERSION.zip" \
  --requirement "https://raw.githubusercontent.com/cloudify-cosmo/cloudify-cli/$CFY_VERSION/dev-requirements.txt"

You can set the CFY_VERSION variable to any desired version from version list.