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.

Type: object
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.

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