OS Manuals

/usr/bin/zenohd

Eclipse Zenoh router daemon (zenohd) with the REST and storage-manager plugins

From zenoh 1.10.2-r3 (enterprise-packages), captured 2026-11-09 by running zenohd --help (exit 0). permalink

2026-11-09T15:24:11.519100Z  INFO main ThreadId(01) zenohd: zenohd v1.10.2 built with rustc 1.97.1 (8bab26f4f 2026-07-14)
The zenoh router

Usage: zenohd [OPTIONS]

Options:
  -c, --config <PATH>
          The configuration file. Currently, this file must be a valid JSON5 or YAML file

  -l, --listen <ENDPOINT>
          Locators on which this router will listen for incoming sessions. Repeat this option to open several listeners

  -e, --connect <ENDPOINT>
          A peer locator this router will try to connect to. Repeat this option to connect to several peers

  -i, --id <ID>
          The identifier (as an hexadecimal string, with odd number of chars - e.g.: A0B23...) that zenohd must use. If not set, a random unsigned 128bit integer will be used. WARNING: this identifier must be unique in the system and must be 16 bytes maximum (32 chars)!

  -P, --plugin <PLUGIN>
          A plugin that MUST be loaded. You can give just the name of the plugin, zenohd will search for a library named 'libzenoh_plugin_\<name\>.so' (exact name depending the OS). Or you can give such a string: "\<plugin_name\>:\<library_path\>" Repeat this option to load several plugins. If loading failed, zenohd will exit

      --plugin-search-dir <PATH>
          Directory where to search for plugins libraries to load. Repeat this option to specify several search directories

      --no-timestamp
          By default zenohd adds a HLC-generated Timestamp to each routed Data if there isn't already one. This option disables this feature

      --no-multicast-scouting
          By default zenohd replies to multicast scouting messages for being discovered by peers and clients. This option disables this feature

      --rest-http-port <SOCKET>
          Enables REST API plugin and configures HTTP interface for it. Accepted values: - a port number - a string with format `<local_ip>:<port_number>` (to bind the HTTP server to a specific interface)

      --cfg <CFG>
          Allows arbitrary configuration changes as column-separated KEY:VALUE pairs, where the empty key is used to represent the entire configuration: - KEY must be a valid config path, or empty string if the whole configuration is defined. - VALUE must be a valid JSON5 string that can be deserialized to the expected type for the KEY field.

          Examples: - `--cfg='startup/subscribe:["demo/**"]'` - `--cfg='plugins/storage_manager/storages/demo:{key_expr:"demo/example/**",volume:"memory"}'` - `--cfg=':{metadata:{name:"My App"},adminspace:{enabled:true,permissions:{read:true,write:true}}'`

      --adminspace-permissions <[r|w|rw|none]>
          Configure the read and/or write permissions on the admin space. Default is read only

  -h, --help
          Print help (see a summary with '-h')

  -V, --version
          Print version
Options (13)
OptionDescriptionSource
-c, --config PATHThe configuration file.help
-l, --listen ENDPOINTLocators on which this router will listen for incoming sessions.help
-e, --connect ENDPOINTA peer locator this router will try to connect to.help
-i, --id IDThe identifier (as an hexadecimal string, with odd number of chars - e.g.: A0B23...) that zenohd must use.help
-P, --plugin PLUGINA plugin that MUST be loaded.help
--plugin-search-dir PATHDirectory where to search for plugins libraries to load.help
--no-timestampBy default zenohd adds a HLC-generated Timestamp to each routed Data if there isn't already one.help
--no-multicast-scoutingBy default zenohd replies to multicast scouting messages for being discovered by peers and clients.help
--rest-http-port SOCKETEnables REST API plugin and configures HTTP interface for it.help
--cfg CFGAllows arbitrary configuration changes as column-separated KEY:VALUE pairs, where the empty key is used to represent the entire configuration: - KEY must be a valid config path, or empty string if…help
--adminspace-permissions r|w|rw|noneConfigure the read and/or write permissions on the admin space.help
-h, --helpPrint help (see a summary with '-h')help
-V, --versionPrint versionhelp

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.