The Dream SDK includes an application called mindtouch.host.exe. It provides a command line interface for creating a new Dream hosting environment. The application can be run multiple times side-by-side, as long as each instance is given a different port to listen on.
The console host application has the following command line parameters.
| Argument | Type | Description |
| config | filename | Optional. Host configuration xml file. (default: built from command line) |
| public-uri | uri | Optioanl. Public uri for server for non local:// uris. (default: http://localhost:8081) |
| server-name | uri | Optional. Server name to use for local:// uris. (default: http://localhost) |
| server-path | path | Optional. Path to prepend to uri for each requst received through http-listener. (default: nothing) |
| http-port | int | Optional. Port on which Dream is listening for requests. (default: 8081) |
| service-dir | path | Optional. Folder for storing service state. (default: host directory) |
| script | filename | Optional. XML startup script. (default: none) |
| notty | Optional. Runs application as daemon, and will have to be shutdown with a REST call. | |
| ip | ip-address | Optional. Listen only on this network address and port (use 'localhost' to only allow local access). (default: all available interfaces) |
| apikey | text | Optional. Acces key for privileged operations on the host service. (default: auto-generated 128-bit key) |
| capture-stack-trace | Optional. Capture stack trace for asynchronous calls. | |
| nolog | Optional. Disable logging. | |
| connect-limit | int | Optional. Maximum number of simultaneous connections. (negative: relative to max threads, default: no limit) |
| guid | guid | Optional. Set GUID for host. (default: auto-generated 128-bit key) |
For example, the arguments could be used as follows:
mindtouch.host.exe http-port 8088 script myscript.xml