Complete General Settings Index

This reference is generated from GeneralSettings and covers all 421 declared fields. Use general_settings in config.yaml; values can reference an environment variable with the os.environ/NAME form.

The generated schema is the field-coverage source of truth. The General settings guide explains operational choices, precedence, and safe examples. A default shown here is not automatically a production recommendation.

Authentication, identity, and sessions

Setting	Type	Default	Constraints	Handling
custom_auth	string or null	null	—	Ordinary
deltallm_key_header_name	string	"Authorization"	—	Ordinary
enable_jwt_auth	boolean	false	—	Ordinary
enable_sso	boolean	false	—	Ordinary
external_auth	ExternalAuthSettings	Factory default	—	Startup trust; excluded from settings API
jwt_audience	string or null	null	—	Ordinary
jwt_claims_mapping	object of string	Factory default	—	Ordinary
jwt_issuer	string or null	null	—	Ordinary
jwt_public_key_url	string or null	null	—	Ordinary
master_key	string or null	null	—	Secret
password_login_enabled	boolean	true	—	Ordinary
platform_bootstrap_admin_email	string or null	null	—	Ordinary
platform_bootstrap_admin_password	string or null	null	—	Secret
salt_key	string or null	null	—	Secret
self_registration	SelfRegistrationSettings	Factory default	—	Ordinary
sso_admin_email_list	array of string	Factory default	—	Ordinary
sso_authorize_url	string or null	null	—	Ordinary
sso_client_id	string or null	null	—	Ordinary
sso_client_secret	string or null	null	—	Secret
sso_default_team_id	string or null	null	—	Ordinary
sso_group_sync	SSOGroupSyncSettings	Factory default	—	Ordinary
sso_local_mfa	"optional" or "trust_idp"	"optional"	—	Ordinary
sso_provider	"microsoft" or "google" or "okta" or "oidc" or "saml"	"oidc"	—	Ordinary
sso_redirect_uri	string or null	null	—	Ordinary
sso_scope	string	"openid email profile"	—	Ordinary
sso_sign_in	SSOSignInSettings	Factory default	—	Ordinary
sso_state_ttl_seconds	integer	600	≤ 3600; ≥ 60	Ordinary
sso_token_url	string or null	null	—	Ordinary
sso_userinfo_url	string or null	null	—	Ordinary

Database and telemetry ingestion

Setting	Type	Default	Constraints	Handling
accounting_execution_mode	"assigned" or "local_journal"	"assigned"	—	Ordinary
accounting_finalization_ack_timeout_ms	integer	2000	≤ 5000; ≥ 10	Ordinary
accounting_finalization_max_pending	integer	8192	≤ 100000; ≥ 1	Ordinary
accounting_finalization_max_pending_bytes	integer	8388608	≤ 67108864; ≥ 1048576	Ordinary
accounting_grant_target_operations	integer	32	≤ 1024; ≥ 1	Ordinary
accounting_grant_ttl_seconds	integer	30	≤ 300; ≥ 1	Ordinary
accounting_grants_enabled	boolean	true	—	Ordinary
accounting_hot_path_db_pool_size	integer	2	≤ 32; ≥ 1	Ordinary
accounting_local_max_subjects	integer	1024	≤ 4096; ≥ 1	Ordinary
accounting_max_provider_attempts	integer	3	≤ 128; ≥ 1	Ordinary
accounting_microbatch_dwell_ms	integer	2	≤ 50; ≥ 0	Ordinary
accounting_microbatch_max_size	integer	8	≤ 256; ≥ 1	Ordinary
accounting_projection_batch_size	integer	64	≤ 256; ≥ 1	Ordinary
accounting_projection_lease_seconds	integer	30	≤ 300; ≥ 5	Ordinary
accounting_projection_maintenance_interval_ms	integer	1000	≤ 60000; ≥ 100	Ordinary
accounting_projection_max_concurrent_partitions	integer	4	≤ 64; ≥ 1	Ordinary
accounting_projection_poll_interval_ms	integer	50	≤ 10000; ≥ 10	Ordinary
accounting_projection_worker_enabled	boolean	false	—	Ordinary
accounting_protocol_enabled	boolean	false	—	Ordinary
accounting_protocol_generation	integer	1	≤ 9223372036854775807; ≥ 1	Ordinary
accounting_request_url	string or null	null	max length 2048	Ordinary
accounting_reservation_ack_timeout_ms	integer	1000	≤ 5000; ≥ 10	Ordinary
accounting_reservation_max_pending	integer	4096	≤ 100000; ≥ 1	Ordinary
accounting_reservation_max_pending_bytes	integer	8388608	≤ 67108864; ≥ 1048576	Ordinary
accounting_rpc_allow_http	boolean	false	—	Ordinary
accounting_rpc_allowed_ports	array of integer	[443]	max items 16; min items 1; ≤ 65535; ≥ 1	Ordinary
accounting_rpc_allowed_private_cidrs	array of string	[]	max items 16; max length 128	Ordinary
accounting_rpc_max_connections	integer	16	≤ 256; ≥ 1	Ordinary
accounting_rpc_signing_secret	string or null	null	max length 4096; min length 32	Secret
accounting_statement_timeout_ms	integer	250	≤ 2000; ≥ 10	Ordinary
database_url	string or null	null	—	May contain credentials
spend_ingestion_batch_size	integer	100	≤ 500; ≥ 1	Ordinary
spend_ingestion_cleanup_batch_size	integer	1000	≤ 100000; ≥ 1	Ordinary
spend_ingestion_cleanup_interval_seconds	number	60.0	≤ 86400.0; ≥ 1.0	Ordinary
spend_ingestion_cleanup_max_batches_per_run	integer	10	≤ 1000; ≥ 1	Ordinary
spend_ingestion_cleanup_time_budget_seconds	number	2.0	> 0.0; ≤ 60.0	Ordinary
spend_ingestion_completed_retention_hours	integer	1	≤ 720; ≥ 0	Ordinary
spend_ingestion_failed_retention_days	integer	30	≤ 3650; ≥ 1	Ordinary
spend_ingestion_fallback_execution_timeout_seconds	number	2.0	> 0.0; ≤ 60.0	Ordinary
spend_ingestion_fallback_max_concurrency	integer	1	≤ 32; ≥ 1	Ordinary
spend_ingestion_fallback_max_waiters	integer	8	≤ 10000; ≥ 0	Ordinary
spend_ingestion_fallback_queue_timeout_ms	integer	100	≤ 60000; ≥ 1	Ordinary
spend_ingestion_flush_interval_ms	integer	100	≤ 10000; ≥ 10	Ordinary
spend_ingestion_lease_seconds	integer	30	≤ 300; ≥ 5	Ordinary
spend_ingestion_max_attempts	integer	10	≤ 100; ≥ 1	Ordinary
spend_ingestion_max_pending_events	integer	100000	≤ 10000000; ≥ 1	Ordinary
spend_ingestion_mode	"legacy" or "outbox"	"legacy"	—	Ordinary
spend_ingestion_overload_policy	"sync_fallback" or "fail_closed"	"sync_fallback"	—	Ordinary
spend_ingestion_worker_enabled	boolean	true	—	Ordinary
telemetry_db_pool_size	integer	5	> 0; ≤ 100	Ordinary
telemetry_db_pool_timeout_seconds	integer	2	≤ 60; ≥ 0	Ordinary
telemetry_shutdown_drain_timeout_seconds	number	20.0	≤ 300; ≥ 0.1	Ordinary
telemetry_worker_db_pool_size	integer	5	≤ 100; ≥ 1	Ordinary
telemetry_worker_startup_timeout_seconds	number	5.0	≤ 60; ≥ 0.1	Ordinary

Redis and caching

Setting	Type	Default	Constraints	Handling
cache_backend	"memory" or "redis" or "s3"	"memory"	—	Ordinary
cache_enabled	boolean	false	—	Ordinary
cache_invalidation_immediate_timeout_seconds	number	0.5	> 0; ≤ 30	Ordinary
cache_invalidation_max_attempts	integer	10	≤ 100; ≥ 1	Ordinary
cache_invalidation_retry_initial_seconds	integer	5	≥ 1	Ordinary
cache_invalidation_retry_max_seconds	integer	300	≥ 1	Ordinary
cache_invalidation_worker_batch_size	integer	25	≤ 500; ≥ 1	Ordinary
cache_invalidation_worker_enabled	boolean	true	—	Ordinary
cache_invalidation_worker_lease_seconds	integer	60	≥ 5	Ordinary
cache_invalidation_worker_max_concurrency	integer	4	≤ 50; ≥ 1	Ordinary
cache_invalidation_worker_poll_interval_seconds	number	5.0	> 0	Ordinary
cache_invalidation_worker_record_timeout_seconds	number	10.0	> 0; ≤ 300	Ordinary
cache_max_size	integer	10000	—	Ordinary
cache_ttl	integer	3600	—	Ordinary
prompt_cache_l1_max_entries	integer	10000	≤ 1000000; ≥ 100	Ordinary
prompt_cache_l1_ttl_seconds	integer	30	≥ 1	Ordinary
prompt_cache_l2_ttl_seconds	integer	300	≥ 1	Ordinary
prompt_negative_cache_enabled	boolean	false	—	Ordinary
prompt_negative_l1_ttl_seconds	integer	5	≥ 1	Ordinary
prompt_negative_l2_ttl_seconds	integer	30	≥ 1	Ordinary
redis_acquisition_timeout_seconds	number	0.2	≤ 30; ≥ 0.001	Ordinary
redis_bulk_max_connections	integer	16	≤ 10000; ≥ 1	Ordinary
redis_bulk_max_waiters	integer	0	≤ 10000; ≥ 0	Ordinary
redis_bulk_url	string or null	null	—	Secret
redis_cache_max_connections	integer	16	≤ 10000; ≥ 1	Ordinary
redis_cache_max_waiters	integer	0	≤ 10000; ≥ 0	Ordinary
redis_connect_timeout_seconds	number	1.0	≤ 30; ≥ 0.001	Ordinary
redis_critical_max_connections	integer	64	≤ 10000; ≥ 1	Ordinary
redis_critical_max_waiters	integer	64	≤ 10000; ≥ 0	Ordinary
redis_degraded_mode	"fail_open" or "fail_closed"	"fail_open"	—	Ordinary
redis_host	string	"localhost"	—	Ordinary
redis_password	string or null	null	—	Secret
redis_port	integer	6379	—	Ordinary
redis_socket_timeout_seconds	number	1.0	≤ 30; ≥ 0.001	Ordinary
redis_url	string or null	null	—	May contain credentials

Gateway and upstream capacity

Setting	Type	Default	Constraints	Handling
gateway_ingress_body_timeout_seconds	number	10.0	> 0; ≤ 300	Ordinary
gateway_ingress_control_max_active	integer	16	≤ 1000; ≥ 1	Ordinary
gateway_ingress_control_max_buffered_bytes	integer	67108864	≤ 4294967296; ≥ 1	Ordinary
gateway_ingress_enabled	boolean	false	—	Ordinary
gateway_ingress_health_max_active	integer	4	≤ 100; ≥ 1	Ordinary
gateway_ingress_max_active	integer	100	≤ 100000; ≥ 1	Ordinary
gateway_ingress_max_body_bytes	integer	33554432	≤ 1073741824; ≥ 1	Ordinary
gateway_ingress_max_buffered_bytes	integer	67108864	≤ 4294967296; ≥ 1	Ordinary
gateway_ingress_max_waiters	integer	0	≤ 10000; ≥ 0	Ordinary
gateway_ingress_queue_timeout_ms	integer	10	≤ 1000; ≥ 1	Ordinary
gateway_preflight_capacity_enabled	boolean	false	—	Ordinary
gateway_preflight_global_max_parallel	integer	300	> 0; ≤ 100000	Ordinary
gateway_preflight_lease_ttl_seconds	integer	30	≤ 300; ≥ 5	Ordinary
gateway_preflight_org_max_parallel	integer	100	≤ 100000; ≥ 0	Ordinary
realtime	RealtimeSettings	Factory default	—	Ordinary
upstream_http_connect_timeout_seconds	number	10.0	> 0	Ordinary
upstream_http_keepalive_expiry_seconds	number	60.0	≥ 0	Ordinary
upstream_http_max_connections	integer	500	> 0	Ordinary
upstream_http_max_keepalive_connections	integer	100	≥ 0	Ordinary
upstream_http_pool_timeout_seconds	number	10.0	> 0	Ordinary
upstream_http_read_timeout_seconds	number	300.0	> 0	Ordinary
upstream_http_write_timeout_seconds	number	30.0	> 0	Ordinary

Spend, budgets, and reporting

Setting	Type	Default	Constraints	Handling
budget_alert_ttl_seconds	integer	3600	≤ 2147483647; ≥ 60	Ordinary
budget_enforcement_query_mode	"legacy" or "shadow" or "combined"	"legacy"	—	Ordinary
budget_enforcement_query_timeout_seconds	number	2.0	> 0.0; ≤ 30.0	Ordinary
budget_enforcement_shadow_sample_rate	number	0.01	≤ 1.0; ≥ 0.0	Ordinary
budget_notifications_enabled	boolean	false	—	Ordinary
spend_operation_intents_enabled	boolean	false	—	Ordinary
spend_reporting_execution_timeout_seconds	number	60.0	> 0	Ordinary
spend_reporting_global_max_concurrency	integer	2	> 0; ≤ 64	Ordinary
spend_reporting_max_concurrency	integer	2	> 0; ≤ 32	Ordinary
spend_reporting_queue_timeout_seconds	number	10.0	> 0	Ordinary
spend_reporting_redis_timeout_seconds	number	0.5	> 0	Ordinary
spend_reporting_v2_enabled	boolean	true	—	Ordinary
spend_settlement_db_pool_size	integer	1	≤ 99; ≥ 1	Ordinary

Organizations and governance

Setting	Type	Default	Constraints	Handling
callable_target_scope_policy_mode	"legacy" or "shadow" or "enforce"	"enforce"	—	Ordinary
governance_notifications_enabled	boolean	false	—	Ordinary
organization_deletion_max_attempts	integer	20	≤ 100; ≥ 1	Ordinary
organization_deletion_recovery_window_hours	integer	168	≤ 720; ≥ 1	Ordinary
organization_deletion_requests_enabled	boolean	false	—	Ordinary
organization_deletion_retry_initial_seconds	integer	5	≥ 1	Ordinary
organization_deletion_retry_max_seconds	integer	300	≥ 1	Ordinary
organization_deletion_waiting_poll_seconds	number	10.0	> 0	Ordinary
organization_deletion_worker_batch_size	integer	5	≤ 100; ≥ 1	Ordinary
organization_deletion_worker_enabled	boolean	true	—	Ordinary
organization_deletion_worker_lease_seconds	integer	60	≥ 5	Ordinary
organization_deletion_worker_max_concurrency	integer	2	≤ 20; ≥ 1	Ordinary
organization_deletion_worker_max_pages_per_claim	integer	10	≤ 100; ≥ 1	Ordinary
organization_deletion_worker_page_size	integer	100	≤ 1000; ≥ 1	Ordinary
organization_deletion_worker_poll_interval_seconds	number	5.0	> 0	Ordinary
organization_deletion_worker_record_timeout_seconds	number	45.0	> 0; ≤ 300	Ordinary
organization_lifecycle_auth_cache_max_entries	integer	10000	≤ 1000000; ≥ 100	Ordinary
organization_lifecycle_auth_max_staleness_seconds	number	3.0	> 0; ≤ 60	Ordinary

Notifications and email

Setting	Type	Default	Constraints	Handling
email_base_url	string or null	null	—	Ordinary
email_enabled	boolean	false	—	Ordinary
email_from_address	string or null	null	—	Ordinary
email_from_name	string or null	null	—	Ordinary
email_max_attempts	integer	5	≤ 20; ≥ 1	Ordinary
email_provider	"smtp" or "resend" or "sendgrid"	"smtp"	—	Ordinary
email_reply_to	string or null	null	—	Ordinary
email_retry_initial_seconds	integer	60	≥ 1	Ordinary
email_retry_max_seconds	integer	3600	≥ 1	Ordinary
email_worker_audit_lease_seconds	integer	30	≤ 300; ≥ 5	Ordinary
email_worker_batch_size	integer	10	≤ 500; ≥ 1	Ordinary
email_worker_delivery_lease_seconds	integer	60	≤ 600; ≥ 10	Ordinary
email_worker_enabled	boolean	true	—	Ordinary
email_worker_max_concurrency	integer	3	≤ 20; ≥ 1	Ordinary
email_worker_poll_interval_seconds	number	5.0	> 0	Ordinary
email_worker_shutdown_drain_timeout_seconds	number	20.0	> 0; ≤ 300	Ordinary
email_worker_startup_timeout_seconds	number	5.0	> 0; ≤ 60	Ordinary
key_lifecycle_notifications_enabled	boolean	false	—	Ordinary
resend_api_key	string or null	null	—	Secret
resend_webhook_signing_secret	string or null	null	—	Secret
resend_webhook_tolerance_seconds	integer	300	≤ 3600; ≥ 30	Ordinary
sendgrid_api_key	string or null	null	—	Secret
slack_alert_kinds	array of string	Factory default	—	Ordinary
slack_alerting_enabled	boolean	false	—	Ordinary
slack_webhook_url	string or null	null	—	Secret
smtp_host	string or null	null	—	Ordinary
smtp_password	string or null	null	—	Secret
smtp_port	integer	587	≤ 65535; ≥ 1	Ordinary
smtp_use_starttls	boolean	true	—	Ordinary
smtp_use_tls	boolean	false	—	Ordinary
smtp_username	string or null	null	—	Ordinary

Model deployments and routing

Setting	Type	Default	Constraints	Handling
failover_event_history_size	integer	1000	> 0	Ordinary
model_deployment_bootstrap_from_config	boolean	true	—	Ordinary
model_deployment_source	"hybrid" or "db_only" or "config_only"	"hybrid"	—	Ordinary

Batch execution

Setting	Type	Default	Constraints	Handling
batch_completed_artifact_retention_days	integer	7	—	Ordinary
batch_failed_artifact_retention_days	integer	14	—	Ordinary
batch_metadata_retention_days	integer	30	—	Ordinary
batch_webhook_allow_http	boolean	false	—	Ordinary
batch_webhook_allowed_ports	array of integer	Factory default	—	Ordinary
batch_webhook_allowed_private_cidrs	array of string	Factory default	—	Ordinary
batch_webhook_cleanup_max_rows_per_run	integer	10000	≤ 1000000; ≥ 1	Ordinary
batch_webhook_delivery_retention_days	integer	30	≥ 1	Ordinary
batch_webhook_enabled	boolean	false	—	Ordinary
batch_webhook_encryption_key	string or null	null	—	Secret
batch_webhook_lease_seconds	integer	30	≥ 5	Ordinary
batch_webhook_max_attempts	integer	8	≤ 50; ≥ 1	Ordinary
batch_webhook_max_concurrency	integer	4	≤ 100; ≥ 1	Ordinary
batch_webhook_observability_enabled	boolean	true	—	Ordinary
batch_webhook_observability_refresh_interval_seconds	number	15.0	> 0.0	Ordinary
batch_webhook_poll_interval_seconds	number	1.0	> 0.0	Ordinary
batch_webhook_retry_initial_seconds	integer	5	≥ 1	Ordinary
batch_webhook_retry_max_seconds	integer	3600	≥ 1	Ordinary
batch_webhook_timeout_seconds	number	10.0	> 0.0	Ordinary
batch_webhook_worker_enabled	boolean	true	—	Ordinary
embeddings_batch_advisory_lock_mode	"dual" or "canonical"	"dual"	—	Ordinary
embeddings_batch_aging_seconds_per_work_unit	integer	30	≥ 1	Ordinary
embeddings_batch_claim_diagnostic_interval_seconds	number	60.0	≥ 1.0	Ordinary
embeddings_batch_claim_diagnostic_max_keys	integer	1024	≤ 100000; ≥ 1	Ordinary
embeddings_batch_claim_diagnostics_enabled	boolean	true	—	Ordinary
embeddings_batch_completion_outbox_worker_enabled	boolean	true	—	Ordinary
embeddings_batch_create_idempotency_enabled	boolean	false	—	Ordinary
embeddings_batch_create_promotion_insert_chunk_size	integer	500	≤ 10000; ≥ 1	Ordinary
embeddings_batch_create_promotion_tx_max_wait_seconds	number	10.0	> 0.0	Ordinary
embeddings_batch_create_promotion_tx_timeout_seconds	number	60.0	> 0.0	Ordinary
embeddings_batch_create_session_cleanup_enabled	boolean	true	—	Ordinary
embeddings_batch_create_session_cleanup_interval_seconds	number	3600.0	> 0	Ordinary
embeddings_batch_create_session_cleanup_scan_limit	integer	200	≤ 1000; ≥ 1	Ordinary
embeddings_batch_create_session_completed_retention_seconds	integer	604800	≥ 60	Ordinary
embeddings_batch_create_session_failed_retention_seconds	integer	1209600	≥ 60	Ordinary
embeddings_batch_create_session_retryable_retention_seconds	integer	259200	≥ 60	Ordinary
embeddings_batch_create_soft_precheck_enabled	boolean	true	—	Ordinary
embeddings_batch_create_stage_orphan_grace_seconds	integer	3600	≥ 60	Ordinary
embeddings_batch_default_model_max_claim_work_units	integer	64	≥ 1	Ordinary
embeddings_batch_default_model_max_in_flight	integer	16	≥ 1	Ordinary
embeddings_batch_enabled	boolean	false	—	Ordinary
embeddings_batch_finalization_first	boolean	true	—	Ordinary
embeddings_batch_finalization_page_size	integer	500	≤ 10000; ≥ 10	Ordinary
embeddings_batch_finalization_retry_delay_seconds	integer	60	≥ 1	Ordinary
embeddings_batch_gc_enabled	boolean	true	—	Ordinary
embeddings_batch_gc_interval_seconds	number	86400.0	—	Ordinary
embeddings_batch_gc_scan_limit	integer	200	—	Ordinary
embeddings_batch_heartbeat_interval_seconds	number	15.0	> 0	Ordinary
embeddings_batch_item_buffer_multiplier	integer	2	≤ 10; ≥ 1	Ordinary
embeddings_batch_item_claim_limit	integer	20	—	Ordinary
embeddings_batch_item_lease_seconds	integer	360	≥ 30	Ordinary
embeddings_batch_job_lease_seconds	integer	120	≥ 5	Ordinary
embeddings_batch_max_age_credit_work_units	integer	1000	≥ 0	Ordinary
embeddings_batch_max_attempts	integer	3	—	Ordinary
embeddings_batch_max_file_bytes	integer	52428800	≥ 1024	Ordinary
embeddings_batch_max_items_per_batch	integer	10000	≥ 1	Ordinary
embeddings_batch_max_line_bytes	integer	1048576	≥ 1024	Ordinary
embeddings_batch_max_pending_batches_per_scope	integer	20	≥ 0	Ordinary
embeddings_batch_microbatch_max_group_retries	integer	2	≥ 0	Ordinary
embeddings_batch_microbatch_min_reduced_size	integer	1	≥ 1	Ordinary
embeddings_batch_microbatch_reduce_factor	number	0.5	> 0.0; ≤ 1.0	Ordinary
embeddings_batch_microbatch_retry_enabled	boolean	true	—	Ordinary
embeddings_batch_min_large_job_claim_interval_seconds	integer	30	≥ 0	Ordinary
embeddings_batch_model_capacity_enabled	boolean	false	—	Ordinary
embeddings_batch_model_capacity_fail_open	boolean	false	—	Ordinary
embeddings_batch_model_capacity_fraction	number	0.25	> 0.0; ≤ 1.0	Ordinary
embeddings_batch_model_capacity_refresh_seconds	number	5.0	> 0.0	Ordinary
embeddings_batch_model_group_backpressure_enabled	boolean	true	—	Ordinary
embeddings_batch_model_group_backpressure_max_seconds	integer	300	≥ 1	Ordinary
embeddings_batch_model_group_backpressure_min_seconds	integer	5	≥ 1	Ordinary
embeddings_batch_poll_interval_seconds	number	1.0	—	Ordinary
embeddings_batch_retry_initial_seconds	integer	5	≥ 1	Ordinary
embeddings_batch_retry_jitter	boolean	true	—	Ordinary
embeddings_batch_retry_max_seconds	integer	300	≥ 1	Ordinary
embeddings_batch_retry_multiplier	number	2.0	≥ 1.0	Ordinary
embeddings_batch_s3_access_key_id	string or null	null	—	Ordinary
embeddings_batch_s3_bucket	string or null	null	—	Ordinary
embeddings_batch_s3_endpoint_url	string or null	null	—	Ordinary
embeddings_batch_s3_prefix	string	"deltallm/batch-artifacts"	—	Ordinary
embeddings_batch_s3_region	string	"us-east-1"	—	Ordinary
embeddings_batch_s3_secret_access_key	string or null	null	—	Ordinary
embeddings_batch_s3_spool_max_bytes	integer	8388608	> 0	Ordinary
embeddings_batch_scheduler_backfill_enabled	boolean	false	—	Ordinary
embeddings_batch_scheduler_backfill_interval_seconds	number	60.0	> 0.0	Ordinary
embeddings_batch_scheduler_backfill_scan_limit	integer	500	≤ 5000; ≥ 1	Ordinary
embeddings_batch_scheduler_base_quantum_work_units	integer	16	≥ 1	Ordinary
embeddings_batch_scheduler_claim_mode	"job_fifo" or "work_slice"	"job_fifo"	—	Ordinary
embeddings_batch_scheduler_default_service_tier	string	"standard"	—	Ordinary
embeddings_batch_scheduler_enabled	boolean	false	—	Ordinary
embeddings_batch_scheduler_estimator_version	"v1"	"v1"	—	Ordinary
embeddings_batch_scheduler_max_active_flows_per_decision	integer	100	≤ 1000; ≥ 1	Ordinary
embeddings_batch_scheduler_max_candidate_jobs_per_flow	integer	50	≤ 1000; ≥ 1	Ordinary
embeddings_batch_scheduler_max_deficit_multiplier	integer	8	≥ 1	Ordinary
embeddings_batch_scheduler_mode	"fifo_v1" or "slice_v1" or "model_capacity_v1" or "fair_share_v1" or "smart_v1"	"fifo_v1"	—	Ordinary
embeddings_batch_scheduler_shadow_decision_timeout_seconds	number	0.5	> 0.0	Ordinary
embeddings_batch_scheduler_shadow_enabled	boolean	false	—	Ordinary
embeddings_batch_scheduler_shadow_max_pending_decisions	integer	16	≥ 0	Ordinary
embeddings_batch_scheduler_shadow_mode	"none" or "fifo_v1" or "slice_v1" or "model_capacity_v1" or "fair_share_v1" or "smart_v1"	"none"	—	Ordinary
embeddings_batch_scheduler_strict_model_homogeneity_enabled	boolean	false	—	Ordinary
embeddings_batch_size_aware_scheduling_enabled	boolean	false	—	Ordinary
embeddings_batch_small_job_fast_lane_enabled	boolean	false	—	Ordinary
embeddings_batch_small_job_max_work_units	integer	100	≥ 1	Ordinary
embeddings_batch_stale_lease_sweeper_enabled	boolean	true	—	Ordinary
embeddings_batch_stale_lease_sweeper_failure_interval_seconds	number	30.0	> 0.0	Ordinary
embeddings_batch_stale_lease_sweeper_interval_seconds	number	60.0	> 0.0	Ordinary
embeddings_batch_stale_lease_sweeper_max_rows_per_run	integer	500	≤ 5000; ≥ 1	Ordinary
embeddings_batch_stale_lease_sweeper_page_size	integer	100	≤ 1000; ≥ 1	Ordinary
embeddings_batch_storage_backend	"local" or "s3"	"local"	—	Ordinary
embeddings_batch_storage_chunk_size	integer	65536	≥ 1024	Ordinary
embeddings_batch_storage_dir	string	".deltallm/batch-artifacts"	—	Ordinary
embeddings_batch_tenant_fair_share_disabled_model_groups	array of string	Factory default	—	Ordinary
embeddings_batch_tenant_fair_share_enabled	boolean	false	—	Ordinary
embeddings_batch_tenant_max_in_flight_work_units	integer	0	≥ 0	Ordinary
embeddings_batch_tenant_max_queued_work_units	integer	0	≥ 0	Ordinary
embeddings_batch_tenant_scope_preference	string	"organization,team,api_key,user"	—	Ordinary
embeddings_batch_work_claim_max_items	integer	0	≤ 200; ≥ 0	Ordinary
embeddings_batch_work_claim_max_work_units	integer	0	≥ 0	Ordinary
embeddings_batch_work_claim_min_items_for_microbatch	integer	4	≤ 200; ≥ 1	Ordinary
embeddings_batch_worker_concurrency	integer	4	≤ 100; ≥ 1	Ordinary
embeddings_batch_worker_enabled	boolean	true	—	Ordinary

Tier policy and capacity

Setting	Type	Default	Constraints	Handling
tier_capacity_fair_share_active_ttl_seconds	integer	10	≤ 300; ≥ 1	Ordinary
tier_capacity_fair_share_enabled	boolean	false	—	Ordinary
tier_policy_missing_service_mode	"fail_open" or "fail_closed"	"fail_open"	—	Ordinary
tier_policy_mode	"disabled" or "shadow" or "enforce"	"disabled"	—	Ordinary
tier_policy_refresh_interval_seconds	number	300.0	> 0.0	Ordinary
tier_policy_refresh_jitter_seconds	number	1.0	≥ 0.0	Ordinary
tier_policy_refresh_retry_delay_seconds	number	5.0	> 0.0	Ordinary
tier_policy_transition_grace_seconds	number	0.05	≥ 0.0	Ordinary

Audit

Setting	Type	Default	Constraints	Handling
audit_control_sync_actions	array of string	Factory default	—	Ordinary
audit_control_sync_enabled	boolean	true	—	Ordinary
audit_enabled	boolean	true	—	Ordinary
audit_ingestion_batch_size	integer	100	≤ 500; ≥ 1	Ordinary
audit_ingestion_cleanup_batch_size	integer	1000	≤ 100000; ≥ 1	Ordinary
audit_ingestion_cleanup_interval_seconds	number	60.0	≤ 86400.0; ≥ 1.0	Ordinary
audit_ingestion_cleanup_max_batches_per_run	integer	10	≤ 1000; ≥ 1	Ordinary
audit_ingestion_cleanup_time_budget_seconds	number	2.0	> 0.0; ≤ 60.0	Ordinary
audit_ingestion_completed_retention_hours	integer	1	≤ 720; ≥ 0	Ordinary
audit_ingestion_failed_retention_days	integer	30	≤ 3650; ≥ 1	Ordinary
audit_ingestion_flush_interval_ms	integer	100	≤ 10000; ≥ 10	Ordinary
audit_ingestion_lease_seconds	integer	30	≤ 300; ≥ 5	Ordinary
audit_ingestion_max_attempts	integer	10	≤ 100; ≥ 1	Ordinary
audit_ingestion_max_pending_events	integer	100000	≤ 10000000; ≥ 1	Ordinary
audit_ingestion_mode	"legacy" or "outbox"	"legacy"	—	Ordinary
audit_ingestion_required_reserve	integer	10000	≤ 10000000; ≥ 0	Ordinary
audit_ingestion_worker_enabled	boolean	true	—	Ordinary
audit_metadata_retention_days	integer	365	—	Ordinary
audit_payload_retention_days	integer	90	—	Ordinary
audit_retention_interval_seconds	number	86400.0	—	Ordinary
audit_retention_scan_limit	integer	500	—	Ordinary
audit_retention_worker_enabled	boolean	true	—	Ordinary

UI and branding

Setting	Type	Default	Constraints	Handling
ui_branding	UIBrandingSettings	Factory default	—	Ordinary
ui_mount	UIMountSettings	Factory default	—	Startup only; non-secret UI configuration

Core runtime settings

Setting	Type	Default	Constraints	Handling
api_key_auth_cache_ttl_seconds	integer	300	—	Ordinary
auth_fallback_cache_max_bytes	integer	131072	≤ 1048576; ≥ 1024	Ordinary
auth_fallback_cache_timeout_seconds	number	0.1	≤ 1; ≥ 0.001	Ordinary
auth_fallback_max_active	integer	8	≤ 1000; ≥ 1	Ordinary
auth_fallback_max_waiters	integer	32	≤ 10000; ≥ 0	Ordinary
auth_fallback_queue_timeout_ms	integer	10	≤ 1000; ≥ 1	Ordinary
auth_fallback_timeout_seconds	number	0.5	≤ 30; ≥ 0.01	Ordinary
auth_master_session_ttl_hours	integer or null	null	≤ 168; ≥ 1	Ordinary
auth_session_idle_timeout_minutes	integer	60	≤ 1440; ≥ 0	Ordinary
auth_session_ttl_hours	integer	12	—	Ordinary
background_health_checks	boolean	false	—	Ordinary
callback_max_bytes	integer	8388608	≤ 134217728; ≥ 1024	Ordinary
callback_max_concurrency	integer	4	≤ 64; ≥ 1	Ordinary
callback_max_payload_bytes	integer	262144	≤ 16777216; ≥ 1024	Ordinary
callback_max_pending	integer	128	≤ 4096; ≥ 1	Ordinary
callback_shutdown_seconds	number	5	> 0; ≤ 30	Ordinary
callback_timeout_seconds	number	5	> 0; ≤ 60	Ordinary
db_acquisition_timeout_seconds	number	0.2	≤ 30; ≥ 0.001	Ordinary
db_background_lock_timeout_seconds	number	1.0	≤ 60; ≥ 0.001	Ordinary
db_background_statement_timeout_seconds	number	5.0	≤ 60; ≥ 0.001	Ordinary
db_background_transaction_timeout_seconds	number	10.0	≤ 120; ≥ 0.001	Ordinary
db_foreground_pool_size	integer	8	≤ 100; ≥ 1	Ordinary
db_lock_timeout_seconds	number	0.2	≤ 30; ≥ 0.001	Ordinary
db_pool_size	integer	20	> 0	Ordinary
db_pool_timeout	integer	30	≥ 0	Ordinary
db_statement_timeout_seconds	number	1.0	≤ 30; ≥ 0.001	Ordinary
db_transaction_timeout_seconds	number	2.0	≤ 60; ≥ 0.001	Ordinary
deployment_capacity_path	string or null	null	max length 1024; min length 1	Ordinary
deployment_capacity_role	"api" or "batchWorker" or "accountingWorker" or "accountingRequest"	"api"	—	Ordinary
guardrail_max_bytes	integer	33554432	≤ 268435456; ≥ 1024	Ordinary
guardrail_max_concurrency	integer	2	≤ 32; ≥ 1	Ordinary
guardrail_max_pending	integer	8	≤ 256; ≥ 1	Ordinary
guardrail_shutdown_seconds	number	5	> 0; ≤ 30	Ordinary
guardrail_timeout_seconds	number	5	> 0; ≤ 60	Ordinary
health_check_interval	integer	300	—	Ordinary
health_check_model	string	"gpt-3.5-turbo"	—	Ordinary
instance_name	string	"DeltaLLM"	max length 80; min length 1	Ordinary
invitation_token_ttl_hours	integer	72	≤ 720; ≥ 1	Ordinary
lifecycle_cancellation_seconds	number	5	> 0; ≤ 30	Ordinary
lifecycle_close_seconds	number	5	> 0; ≤ 30	Ordinary
lifecycle_request_drain_seconds	number	45	> 0; ≤ 600	Ordinary
lifecycle_shutdown_seconds	number	80	> 0; ≤ 750	Ordinary
lifecycle_withdrawal_seconds	number	5	≤ 30; ≥ 0	Ordinary
lifecycle_worker_drain_seconds	number	20	> 0; ≤ 60	Ordinary
log_level	"DEBUG" or "INFO" or "WARNING" or "ERROR"	"INFO"	—	Ordinary
managed_asset_authorization_max_staleness_seconds	number	60.0	≤ 3600.0; ≥ 1.0	Ordinary
managed_asset_reconciliation_batch_size	integer	250	≤ 10000; ≥ 1	Ordinary
managed_asset_reconciliation_interval_seconds	number	30.0	≥ 1.0	Ordinary
managed_asset_reconciliation_max_batches_per_run	integer	20	≤ 1000; ≥ 1	Ordinary
managed_asset_snapshot_max_policies	integer	50000	≤ 50000; ≥ 1	Ordinary
metrics_retention_days	integer	30	—	Ordinary
migration_mode	"startup" or "external"	"startup"	—	Ordinary
migration_verify_timeout_seconds	number	10	> 0; ≤ 60	Ordinary
password_reset_token_ttl_minutes	integer	60	≤ 1440; ≥ 5	Ordinary
prometheus_endpoint	string	"/metrics"	—	Ordinary
prompt_singleflight_max_keys	integer	256	≤ 10000; ≥ 1	Ordinary
prompt_singleflight_timeout_seconds	number	2.0	> 0; ≤ 30	Ordinary
provider_discovery_allow_http	boolean	false	—	Ordinary
provider_discovery_allowed_ports	array of integer	Factory default	max items 64; min items 1	Ordinary
provider_discovery_allowed_private_cidrs	array of string	Factory default	max items 128	Ordinary
readiness_cache_seconds	number	1	> 0; ≤ 5	Ordinary
readiness_probe_timeout_seconds	number	1	> 0; ≤ 2	Ordinary
stream_cache_max_bytes	integer	262144	> 0	Ordinary
stream_cache_max_fragments	integer	2048	> 0	Ordinary