Skip to main content
Version: 2.11

remotes

Requires Restart

List of entries specifiying servers where the leaf node client connection can be made.

Properties

NameDescriptionTypeDefaultReloadable
urlURL or list of URLs of a remote server accepting leaf node connections. If username/password or token authentication is required on the remote, this should be encoded in the URL itself, e.g. nats-leaf://username:password@localhost:7422. Note, the URL scheme should be nats-leaf or ws.(multiple)-No
nkeyUser nkey seed this remote authenticates with.string-No
first_info_timeoutHow long to wait for the remote's INFO message before giving up on the connection.duration1sNo
no_randomizeIf true and more than one URL is specified, the first one in the list will be used. If the client disconnects from the server, then the next URL will be used in order.boolean-No
accountAccount name or public NKey identifying the local account to bind to this remote server. Any traffic locally on this account will be forwarded to the remote server.string-No
credentialsPath to a credentials file. This is application when decentralized auth is used on the remote.string-No
tlsTLS configuration for connecting/authenticating with the remote if mutual TLS is required.object-Yes*
hubboolean-No
deny_imports(multiple)-Ignored*
deny_exports(multiple)-Ignored*
ws_compressionIf true, and connecting with the WebSocket protocol, the connection will indicate to the remote that it wishes compression to be used.booleanfalseNo
ws_no_maskingIf true and connecting with the WebSocket protocol, the connection will indicate to the remote that it wishes not to mask outbound WebSocket frames.booleanfalseNo
jetstream_cluster_migratebooleantrueNo
compressionDefines the compression mode to use for a outgoing leafnode connection. If set to on, it will use the s2_auto.(multiple)-Yes*

* See the property page for reload caveats.