# Configuration

> **Deprecation Notice**
> This page describes features that have been removed or replaced in Luxonis Hub. Functionality may be limited and only available
to Hub Original customers. Please refer to the up-to-date guides to provision devices, manage fleets, and deploy applications.

Perception Apps are configured using a [TOML file](https://toml.io/en/) called robotapp.toml. The file is located in root
directory of the app. Here is an example one:

```toml
config_version = "2.0"

[info]
name = "{{{ APP_NAME }}}"
description = "This is a generated description. Replace it with your own."

[runtime]
application = "app.py#Application"
workdir = "/app"

[runtime.runs_on]
type = "image"
name = "ghcr.io/luxonis/robothub-app-v2:2023.326.2033-rvc2-regular"

[[configuration]]
visual = "section"
title = "Upload intervals"

[[configuration]]
key = "image_event_upload_interval_minutes"
label = "Image event upload interval (minutes)"
field = "num_range"
step = 1
min = 1
max = 60
initial_value = 1
```

## Reference

### Root fields

config_version The version of the configuration file format. Currently, the only supported version is 2.0.

### Info

The info section contains information about the app, such as its name and description.

| Field | Description |
| --- | --- |
| `info.name` | The name of the app. Currently unused. |
| `info.description` | The description of the app. Currently unused. |

### Runtime

The runtime section configures the runtime environment of the app.

| Field | Description |
| --- | --- |
| `runtime.application` | The name of the Python file containing the app's main logic. The path is relative to the root directory.
|
| `runtime.workdir` | The working directory of the app. Defaults to `/app`. |
| `runtime.permissions` | The permissions required to run the app. Defaults to `[]`.An example:`permissions = ["gpio", "i2c"] ` |
| `runtime.runs_on` | The runtime container in which the app will run.`type = "image"`The app will run in a container based on the
specified image. The image is pulled before installation.An example:`[runtime.runs_on] type = "image" name =
"ghcr.io/luxonis/robothub-app-v2:2023.326.2033-rvc2-regular" ` |

### Configuration

The configuration section defines the install-time configuration of the app.

Visual

| Type | Description |
| --- | --- |
| `divider` | The divider to use for the configuration section.An example:`[[configuration]] visual = "divider" ` |
| `section` | The section to use for the configuration section.An example:`[[configuration]] visual = "section" title = "Upload
intervals" ` |

Fields

| Type | Description |
| --- | --- |
| `boolean` | A boolean field.An example:`[[configuration]] field = "boolean" key = "my_boolean" label = "Enable feature"
initial_value = true ` |
| `num_range` | A number range field.An example:`[[configuration]] field = "num_range" key = "my_num_range" label = "Range" step =
1 min = 0 max = 100 initial_value = 50 ` |
| `choice` | A choice field.An example:`[[configuration]] field = "choice" key = "my_choice" label = "Choose option" style =
"radio" # ir "dropdown" allow_multiple = false options = [ { key = "option1", label = "Option 1", default = true }, { key =
"option2", label = "Option 2" } ] ` |
| `text` | A text field.An example:`[[configuration]] field = "text" key = "my_text" label = "Text input" prefix = "USD"
initial_value = "Example" ` |
| `time_range` | A time range field.An example:`[[configuration]] field = "time_range" key = "my_time_range" label = "Time range"
initial_value = { from = "08:00", to = "18:00" } ` |
| `roi_rect4_selector` | A ROI selector on live stream field. Defined by 2 points (x0, y0) and (x1, y1).An
example:`[[configuration]] field = "roi_rect4_selector" key = "my_roi_rect4_selector" label = "Detection area" initial_value =
"0,0,1,1" ` |
| `roi_rect8_selector` | A ROI selector on live stream field. Defined by 4 points (x0, y0), (x1, y1), (x2, y2), (x3, y3).An
example:`[[configuration]] field = "roi_rect8_selector" key = "my_roi_rect8_selector" label = "Detection area" initial_value =
"0,0;1,0;0,1;1,1" ` |