Command Line Interface (CLI) Installation

Get the latest docs.

You are looking at documentation for an older release. Not what you want? Use the version selector on the top banner or click here.

Installing the Cloudify CLI

To remotely connect to Cloudify Manager, you can install the Cloudify Command Line Interface (CLI) on a separate host. The Cloudify CLI includes all of the commands necessary to run any actions on Cloudify Manager.

The CLI is deployed by default on the Cloudify manager. When connected to the manager via SSH, CLI commands can be executed locally without deploying the CLI.

After you download the Cloudify CLI installation package, the installation process does not require an active internet connection.

Installing on Linux

To install Cloudify CLI on Linux:

Download the installation package for your package management system, either RPM or DEB.
To install from the CLI on the host, run the command for your operating system.

Centos/RHEL
```
    $ sudo rpm -i <pkg.rpm>
    
```
Where <pkg.rpm> is the path to the installation file.

Debian/Ubuntu
```
    $ sudo dpkg -i <pkg.deb>
    
```
Where <pkg.deb> is the path to the installation file.

Installing on Mac OSX

To install Cloudify CLI on Mac OSX:

Install the package from PyPI (Python Package Index) using python package manager:

pip

    $ sudo pip install cloudify=<Cloudify version, for example: 5.0.5>

Installing on Windows

The Windows installer is a single executable that installs these components:

Python 2.7.x
Pip
Virtualenv
Cloudify

If the Python installation shows an error, install make sure that Microsoft Visual C++ 2008 Redistributable is installed.

The Python setup wizard prompts you to choose to install pip. If you choose not to install pip, it is installed anyway because it is required by the Cloudify environment.

Windows security tools may identify the Cloudify CLI as an unrecognized app. If this happens, select the “more info” option and then click “Run anyway”.

To install Cloudify CLI on Windows:

Download the EXE installation package for Windows.
Run the installer and respond to the prompts in the installation wizard.

Uninstalling the Cloudify CLI

When you uninstall the Cloudify CLI, you only remove the CLI from the local host. This process does not change the configurations on the Cloudify Managers that you used the CLI to connect to.

The Python, pip or Virtualenv packages are not removed when you remove the Cloudify CLI package.

Uninstalling from Linux

To uninstall the CLI from the host, run the command for your operating system.

#### Centos/RHEL
    $ sudo rpm -e cloudify
    

#### Debian/Ubuntu
    $ sudo dpkg -r cloudify

Uninstalling from Mac

To uninstall the CLI from the host, run:

pip uninstall cloudify

Uninstalling from Windows

To uninstall the CLI from the host:

Go to the Control Panel and open Apps.
Select Cloudify CLI and click Uninstall.