# system.general.config

Type: object

##

Type: array
No Additional Items

##

#### SystemGeneralEntry

Type: object
No Additional Properties

##

#### Id

Type: integer

Unique identifier for the system general configuration.

##

#### Ui Certificate

Used to enable HTTPS access to the system. If `ui_certificate` is not configured on boot, it is automatically created by the system.

## Any of

Type: integer
Type: null

##

#### Ui Httpsport

Type: integer

HTTPS port for the web UI.

Value must be greater or equal to `1` and lesser or equal to `65535`

##

#### Ui Httpsredirect

Type: boolean

When set, makes sure that all HTTP requests are converted to HTTPS requests to better enhance security.

##

#### Ui Httpsprotocols

Type: array of enum (of string)

Array of TLS protocol versions enabled for HTTPS connections.

All items must be unique

No Additional Items

##### Each item of this array must be:

Type: enum (of string)

##### Must be one of:

- "TLSv1"
- "TLSv1.1"
- "TLSv1.2"
- "TLSv1.3"

##

#### Ui Port

Type: integer

HTTP port for the web UI.

Value must be greater or equal to `1` and lesser or equal to `65535`

##

#### Ui Address

Type: array of string

A list of valid IPv4 addresses which the system will listen on.

Must contain a minimum of `1` items

No Additional Items

##### Each item of this array must be:

Type: string

##

#### Ui V6Address

Type: array of string

A list of valid IPv6 addresses which the system will listen on.

Must contain a minimum of `1` items

No Additional Items

##### Each item of this array must be:

Type: string

##

#### Ui Allowlist

Type: array of string

A list of IP addresses and networks that are allow to use API and UI. If this list is empty, then all IP addresses are allowed to use API and UI.

No Additional Items

##### Each item of this array must be:

Type: string

##

#### Ui Consolemsg

Type: boolean

Whether to show console messages on the web UI.

##

#### Ui X Frame Options

Type: enum (of string)

X-Frame-Options header policy for web UI security.

##### Must be one of:

- "SAMEORIGIN"
- "DENY"
- "ALLOW_ALL"

##

#### Kbdmap

Type: string

System keyboard layout mapping.

##

#### Timezone

Type: string

System timezone identifier.

Must be at least `1` characters long

##

#### Usage Collection

Whether usage data collection is enabled. `null` if not set.

## Any of

Type: boolean
Type: null

##

#### Wizardshown

Type: boolean

Whether the initial setup wizard has been shown.

##

#### Usage Collection Is Set

Type: boolean

Whether the usage collection preference has been explicitly set.

##

#### Ds Auth

Type: boolean

Controls whether configured Directory Service users that are granted with Privileges are allowed to log in to the Web UI or use TrueNAS API.

Required roles: SYSTEM_GENERAL_READ