- 17 May 2021
- 1 Minute to read
- Print
- DarkLight
- PDF
Configuration Parameters
- Updated on 17 May 2021
- 1 Minute to read
- Print
- DarkLight
- PDF
Romp Configuration Parameters
In addition to command-line arguments, Romp uses a json-based configuration file to define runtime behavior. See below for all the items you can configure.
You can control the behavior of the Romp client through the use of configuration parameters. These can be specified in both a rompconfig.json
configuration file or as a command-line argument.
Because parameters can be defined in multiple places, the values cascade, and is resolved in the following order:
- Command-line argument
rompconfig.json
file in current working directoryrompconfig.json
file in local data store
This means the command-line argument will override all other levels. For example, to enable verbose output for a package installation, use:
> romp install somePackage --log-level=debug
Parameter Reference
Name | Description |
---|---|
cache-packages | A Boolean that indicates whether packages will be cached. This defaults to true. Note that disabling the package cache may result in a package that cannot be uninstalled, since the cached package is used for the uninstall script and package content manifest. |
user-mode | A Boolean that, when true, indicates whether the local datastore will default to %user%\.romp and the local package registry will default as a user-package registry. This defaults to false. |
default-source | A string that, when set, will be used to determine which package source is used when no package source is specified. |
secure-credentials | A Boolean which indicates, when true, that credentials must be entered interactively when using the store command and may not be displayed with the display command. This defaults to false. |
extensions-path | A string that contains the full path of a directory containing .upack extension files to load. This defaults to «localDataStore»\extensions . |
extensions-temp-path | A string that contains the full path of a directory which contains unpacked cached extensions. This defaults to «localDataStore»\temp\extensions . |
log-level | A string that describes the verbosity of Romp's console output. May be: debug , info , warning , or error . The default value is warning . |
proxy | A string that contains the URL of a proxy server to use for any HTTP requests. |
rafts | An object of rafts that Romp has access to, with each property name containing the raft name, and the value being a string that contains either the directory of a file system raft, or the path to a zip file raft. Note that this property will not cascade. |