WebShell Plugin

WebShell Plugin

WebShell is a CloudStack-UI extension designed to perform a clientless SSH connection to a virtual machine. The extension is activated in the CloudStack-UI configuration file and is supported by an additional Docker container. As for the way of WebShell usage, the plugin is similar to NoVNC interface provided by CloudStack. However, WebShell uses the SSH protocol and doesn’t allow VM emergency management.

WebShell Plugin Deployment

To enable WebShell CloudStack-UI Plugin it is required to:

1. Run WebShell container in the backend
2. Enable and configure WebShell plugin in config.json

Starting WebShell Backend

Please check Usage section in the WebShell repository

WebShell configuration

Please configure webShell in the extensions section of the config.json

  "extensions": {
    ...,
    "webShell": true
  }

webShell.address is the address of a WebShell backend. WebShell will not be available unless an address is specified.

Running cloudstack-ui docker container with webshell

docker run -d -p 80:80 --name cloudstack-ui \
           ...
           -e WEBSHELL_PLUGIN_ENDPOINT=http://url/to/webshell-server \
           ...
           -v /path/to/config.json:/static/config/config.json \
           bwsw/cloudstack-ui