The European Weather Cloud is in the pilot phase, access to its resources may be limited. Please see the Terms and Conditions

This article describes the installation of a command-line tool to control Morpheus via its API.  A simple example of rebooting a VM is demonstrated.

Step-by-step guide

As a root user, please follow the below steps,

1. Fetch GPG Keys:

# curl -sSL | sudo gpg2 --import -

2. Download and install Ruby on Rails:

# curl -sSL | bash -s stable --rails

3. Source the environmental variables and install the morpheus-cli gem:

# source /usr/local/rvm/scripts/rvm

# gem install morpheus-cli

4. Run the following commands to log-in as your Morpheus User:

# morpheus remote add



 Added remote EUM HCMP

 Inspecting remote appliance ...

 Status is: READY

 Would you like to login now? (yes/no) [yes]: yes

 Enter Morpheus Credentials for EUM HCMP -

 Username: | USERNAME

 Password: | PASSWORD

 Success! Logged in to EUM HCMP as USERNAME.

5. Later on, the user can log in using the following command:

# morpheus login -r 'EUM HCMP' -u 'USERNAME' -p 'PASSWORD'

6. Run the following to restart a VM:

# morpheus instances restart testvm -y

Restarting instance testvm

# morpheus instances get testvm

Instance Details

ID: 5103
Name: testvm
Cloud: GPD
Type: Centos ECMWF
Layout: Centos-ECMWF-RAW
Version: Centos-ECMWF-RAW
Plan: s2.medium.1
Power Schedule:
Created By: ezzat
Date Created: 02/11/20 10:53 AM
Nodes: 1

Instance Usage
CPU:[|                                                 ]  0.65%

Memory: [||||||||||||                                      ] 23.58%     228.10 MiB / 967.37 MiB

Storage: [||||||||||                                        ] 18.71%       1.87 GiB / 10.00 GiB

Please find the complete CLI documentation here: