Configuration

This page provides a reference for Rumi Controller configuration properties.

Configuration File

The Controller reads configuration from controller.conf, located in the configuration directory. The configuration file path can be overridden with the RUMI_CONTROLLER_CONF environment variable.

Properties

Directory Settings

Property	Description	Default
nv.controller.systemsroot	Root directory for deployed systems	systems/
nv.controller.extroot	Root directory for external libraries	ext/

Connection Settings

Property	Description	Default
nv.controller.containerconnecthandshaketimeout	Timeout for the initial connection handshake with a container (seconds)	15
nv.controller.containerconnectretryinterval	Interval between connection retry attempts to a container (seconds)	1
nv.controller.containerlaunchtimeout	Maximum time to wait for a container to launch	—

For backward compatibility, the legacy property names (nv.controller.xvmconnecthandshaketimeout, nv.controller.xvmconnectretryinterval, nv.controller.xvmlaunchtimeout) are still accepted. If both the new and legacy property names are set, the new name takes precedence.

Compatibility Settings

Property	Description	Default
nv.controller.disablecompatcheck	Disable version compatibility checks between the Controller and containers	false

SSH Settings

Property	Description	Default
SSH user	Username for SSH connections to remote hosts	—
SSH key file	Path to the private key file for SSH authentication	—
SSH port	SSH port on target hosts	22

Environment Variables

Variable	Description
RUMI_CONTROLLER_HOME	Controller installation home directory
RUMI_CONTROLLER_CONF	Path to the controller.conf configuration file