The stackato client is the command-line interface to Stackato. You can use it to push application code up to the server, start and stop applications, create data services and link them to applications, and a number of other application management operations.
The Command Reference has full descriptions of all client commands and options. These details are also available at the command line via the stackato help command.
Using the Windows stackato client with Cygwin is not supported.
To get a list of available commands or help on a particular command:
$ stackato help [COMMAND]
See also the Command Reference for a full list of commands.
Before you can use the client, you must set the target URL (also known as the API Endpoint). This tells the client where it will be pushing applications. For example:
$ stackato target api.stackato.example.com
For a micro cloud VM, it might be something like:
$ stackato target api.stackato-xxxx.local
If there is an HTTP/HTTPS proxy on your network between your client and the Stackato API endpoint, set the following environment variables in your shell as appropriate for your proxy:
With these set, the client will recognize these settings and route appropriately. On Windows the client queries the Internet Settings values so this step should not be necessary.
If you are using Windows on a network with an HTTP proxy, and have modified the %SystemRoot%system32driversetchosts file to resolve a local micro cloud VM, the stackato client may attempt to use this when connecting to your local VM and fail because the entry in hosts is not reflected in the proxy. To work around this problem, enable \*.local in the ProxyOverride registry key HCU/Software/Microsoft/Windows/CurrentVersion/Internet Settings.
To uninstall the client, simply delete the executable and remove any aliases or $PATH modifications you have made for it.