onyx_settings (Resource)

The Onyx workspace settings singleton. Only attributes set in configuration are managed: unset attributes are left untouched server-side, and removing an attribute from configuration stops managing it rather than resetting it. Deleting the resource only removes it from state — the live settings are not changed. At most one onyx_settings resource should exist per deployment.

Example Usage

terraform

# Only the attributes set here are managed; everything else is left
# untouched server-side. Destroying this resource does NOT reset settings.
resource "onyx_settings" "workspace" {
  company_name        = "ACME Corp"
  invite_only_enabled = true
  query_history_type  = "anonymized"
}

Schema

Optional

anonymous_user_enabled (Boolean) Allow anonymous access.
auto_detect_search_filters (Boolean) Automatically detect search filters from queries.
auto_scroll (Boolean) Auto-scroll chat responses.
company_description (String) Company description.
company_name (String) Company name shown in the UI.
craft_default_enabled (Boolean) Workspace default for Onyx Craft access (per-user overrides win).
craft_instructions (String) Workspace-wide instructions injected into every Craft agent (max 4000 chars).
deep_research_enabled (Boolean) Enable the Deep Research feature.
disable_default_assistant (Boolean) Disable the built-in default assistant.
file_token_count_threshold_k (Number) File token threshold (thousands) before indexing instead of inlining.
image_analysis_max_size_mb (Number) Max image size for analysis, in MB.
image_extraction_and_analysis_enabled (Boolean) Extract and analyze images during indexing.
invite_only_enabled (Boolean) Restrict registration to invited users.
maximum_chat_retention_days (Number) Days to retain chat history (Enterprise tier).
multi_model_chat_enabled (Boolean) Allow chatting with multiple models side by side.
query_history_type (String) Query history mode: disabled, anonymized, or normal.
search_ui_enabled (Boolean) Enable Search Mode in the UI (Business+ tier).
temperature_override_enabled (Boolean) Let users override model temperature.
user_file_max_upload_size_mb (Number) Max user file upload size, in MB. Must be at least 1 — the backend treats 0 as unset and substitutes the deployment default.
user_knowledge_enabled (Boolean) Enable user-uploaded knowledge files.

Read-Only

application_status (String) License/billing status (read-only).
ee_features_enabled (Boolean) Whether EE features are unlocked by the license (read-only).
gpu_enabled (Boolean) Whether the deployment has GPU support (read-only).
hide_query_history_from_admin_panel (Boolean) Whether the query history page is hidden in the admin panel. Read-only: controlled by the HIDE_QUERY_HISTORY_FROM_ADMIN_PANEL backend env var.
id (String) Always "settings".
opensearch_indexing_enabled (Boolean) OpenSearch migration flag. Read-only: controlled by the ENABLE_OPENSEARCH_INDEXING_FOR_ONYX backend env var.
seat_count (Number) Licensed seat count (read-only).
show_extra_connectors (Boolean) Whether the extended connector catalog is shown. Read-only: controlled by the SHOW_EXTRA_CONNECTORS backend env var.
tier (String) Resolved license tier: community, business, or enterprise (read-only).
used_seats (Number) Seats in use (read-only).

Import

Import is supported using the following syntax:

The terraform import command can be used, for example:

shell

#!/bin/sh
# Singleton: the import id is always "settings".
terraform import onyx_settings.workspace settings