Installing on Windows

The morpheus cli is capable of running on many platforms due to its ruby runtime. This includes windows based platforms. To get started, we must first ensure ruby is installed. To do this please visit http://rubyinstaller.org/downloads and download at least Ruby version 2.5.1 of the Ruby+Devkit (2.7.x recommended).

NOTE: When installing ruby on windows, make sure the options are selected for adding the ruby binaries to your PATH.

Now that ruby is installed, simply open a PowerShell window and run

gem install morpheus-cli --no-document

The --no-document option is relatively new and can be achieved in previous versions of rubygems by using --no-rdoc --no-ri instead.

A list of installed dependencies should start sliding by the screen. Once this has completed the CLI setup is complete. Now all that must be done is configuring the cli to point to an appliance for use.

morpheus remote add dev https://10.0.2.2 --insecure

The --insecure option tells the cli to ignore SSL errors for this remote appliance.

Credentials are used to acquire an access token which is then stored in the users home directory in a folder called .morpheus. Now all commands provided by the CLI are available for use just as if running in a *nix based environment.