Launch Arguments allow you to customise your dedicated node’s options and commands to your needs
Configuring Launch Arguments
When setting or editing a node’s launch arguments the panel on the left includes arguments which can be modified. The preview panel on the right shows all arguments as they will appear on the node; changes made to the customisable arguments will immediately be reflected in the preview pane.
Depending on the argument’s type it can be customised and will be included in the customisation panel. Arguments will display as a different colour in the preview pane depending on their type:
Arguments shown in blue in the preview pane can be customised.
Boolean arguments can be removed by switching off the corresponding toggle on the left
When only the value is blue the value can be edited but the argument cannot be removed.
Arguments shown in white in the preview pane have been locked by the network and cannot be customised.
System Generated Arguments will display in grey in the preview pane.
A system generated argument while deploying a dedicated node
The same argument after the node has been deployed
Some system generated arguments, such as node key, can be optionally overridden when deploying the node. They cannot be updated once created.
Arguments are grouped together as follows, with the groups separated by a “--” line in the preview pane.
When running a standalone chain’s node, such as a relay chain validator, all launch arguments will be under a single grouping
When running a Parachain node, such as a collator, the Parachain’s arguments will be grouped together here…
Relay chain Arguments
…while the Relay chain’s arguments will be here
If the node requires certain values to be set on the environment you can enter them here
If the network’s launch arguments have been updated the following alert will be shown on the
Launch Configuration tab
Pressing edit will open the argument editor and a blue icon will highlight the change that has been made by the network. In this case, the argument
--rpc-methods has been locked to
Save Changes to accept the changes after reviewing.
Your node will always be restarted after updating the launch arguments
Common Launch Arguments
Launch arguments are specific to the network that you are running a node for, so if you are unsure about a specific argument we recommend reviewing the network’s documentation.
Here are some common Substrate launch arguments
Exposes web sockets, secured by the OnFinality node API key.
Exposes RPC ports, secured by the OnFinality node API key.
When pruning mode is set to archive the node maintains the full block history, for example to run an archive node.
Exposes the metrics endpoint, found under API Endpoints and protected by the node’s OnFinality API Key. For parachains it can be added separately to the