> For the complete documentation index, see [llms.txt](https://docs.rumi.systems/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rumi.systems/rumi-management/reference/controller/configuration.md).

# 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                          | —       |

{% hint style="info" %}
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.
{% endhint %}

### 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 |