Node command-line options
The node can optionally be started with the following command-line options:
-b: The node working directory where all the files are kept (default:
-f: The path to the config file. The path can be absolute or relative to the base directory. Defaults to
-d: Runs the node in development mode. Unsafe in production. Defaults to true on MacOS and desktop versions of Windows. False otherwise.
-n: Do not start the embedded shell locally.
--on-unknown-config-keys <[FAIL,INFO]>: How to behave on unknown node configuration. Defaults to FAIL.
--sshd: Enables SSH server for node administration.
--sshd-port: Sets the port for the SSH server. If not supplied and SSH server is enabled, the port defaults to 2222.
-v: If set, prints logging to the console as well as to a file.
--logging-level=<loggingLevel>: Enable logging at this level and higher. Possible values: ERROR, WARN, INFO, DEBUG, TRACE. Default: INFO.
-h: Show this help message and exit.
-V: Print version information and exit.
[COMMAND]precedes all options. Failing this, the provided arguments will not be in scope for the command and default arguments will be used instead as a result. For example, if
-f custom_config.confprecedes the
[COMMAND], Corda will look for the default
node.confinstead of the specified
clear-network-cache: Clears local copy of network map, on node startup it will be restored from server or file system.
initial-registration: Starts initial node registration with the compatibility zone to obtain a certificate from the Doorman.
-trequired: Network root trust store obtained from network operator.
-p: Network root trust store password obtained from network operator.
generate-node-info: Performs the node start-up tasks necessary to generate the nodeInfo file, saves it to disk, then exits.
generate-rpc-ssl-settings: Generates the SSL keystore and truststore for a secure RPC connection.
corda alias and auto completion for bash and zsh. See
Shell extensions for CLI Applications for more info.
validate-configuration: Validates the actual configuration without starting the node.
Enabling remote debugging
To enable remote debugging of the node, run the node with the following JVM arguments:
java -Dcapsule.jvm.args="-agentlib:jdwp=transport=dt_socket,server=y,suspend=y,address=5005" -jar corda.jar
This will allow you to attach a debugger to your node on port 5005.