config-sample.md +148 −124
1# Sample Configuration1# Sample Configuration
2 2
33Use this example configuration as a starting point. It includes most keys Codex reads from `config.toml`, along with defaults and short notes.Use this example configuration as a starting point. It includes most keys Codex reads from `config.toml`, along with default behaviors, recommended values where helpful, and short notes.
4 4
5For explanations and guidance, see:5For explanations and guidance, see:
6 6
7- [Config basics](https://developers.openai.com/codex/config-basic)7- [Config basics](https://developers.openai.com/codex/config-basic)
8- [Advanced Config](https://developers.openai.com/codex/config-advanced)8- [Advanced Config](https://developers.openai.com/codex/config-advanced)
9- [Config Reference](https://developers.openai.com/codex/config-reference)9- [Config Reference](https://developers.openai.com/codex/config-reference)
1010- [Sandbox and approvals](https://developers.openai.com/codex/security#sandbox-and-approvals)- [Sandbox and approvals](https://developers.openai.com/codex/agent-approvals-security#sandbox-and-approvals)
1111- [Managed configuration](https://developers.openai.com/codex/security#managed-configuration)- [Managed configuration](https://developers.openai.com/codex/enterprise/managed-configuration)
12 12
13Use the snippet below as a reference. Copy only the keys and sections you need into `~/.codex/config.toml` (or into a project-scoped `.codex/config.toml`), then adjust values for your setup.13Use the snippet below as a reference. Copy only the keys and sections you need into `~/.codex/config.toml` (or into a project-scoped `.codex/config.toml`), then adjust values for your setup.
14 14
15```toml15```toml
16# Codex example configuration (config.toml)16# Codex example configuration (config.toml)
17#17#
1818# This file lists all keys Codex reads from config.toml, their default values,# This file lists the main keys Codex reads from config.toml, along with default
1919# and concise explanations. Values here mirror the effective defaults compiled# behaviors, recommended examples, and concise explanations. Adjust as needed.
20# into the CLI. Adjust as needed.
21#20#
22# Notes21# Notes
23# - Root keys must appear before tables in TOML.22# - Root keys must appear before tables in TOML.
28# Core Model Selection27# Core Model Selection
29################################################################################28################################################################################
30 29
3130# Primary model used by Codex. Default: "gpt-5.2-codex" on all platforms.# Primary model used by Codex. Recommended example for most users: "gpt-5.4".
3231model = "gpt-5.2-codex"model = "gpt-5.4"
33 32
3433# Default communication style for supported models. Default: "friendly".# Communication style for supported models. Allowed values: none | friendly | pragmatic
3534# Allowed values: none | friendly | pragmatic# personality = "pragmatic"
36# personality = "friendly"
37 35
38# Optional model override for /review. Default: unset (uses current session model).36# Optional model override for /review. Default: unset (uses current session model).
3937# review_model = "gpt-5.2-codex"# review_model = "gpt-5.4"
40 38
41# Provider id selected from [model_providers]. Default: "openai".39# Provider id selected from [model_providers]. Default: "openai".
42model_provider = "openai"40model_provider = "openai"
44# Default OSS provider for --oss sessions. When unset, Codex prompts. Default: unset.42# Default OSS provider for --oss sessions. When unset, Codex prompts. Default: unset.
45# oss_provider = "ollama"43# oss_provider = "ollama"
46 44
4745# Optional manual model metadata. When unset, Codex auto-detects from model.# Preferred service tier. `fast` is honored only when enabled in [features].
4846# Uncomment to force values.# service_tier = "flex" # fast | flex
47
48# Optional manual model metadata. When unset, Codex uses model or preset defaults.
49# model_context_window = 128000 # tokens; default: auto for model49# model_context_window = 128000 # tokens; default: auto for model
5050# model_auto_compact_token_limit = 0 # tokens; unset uses model defaults# model_auto_compact_token_limit = 64000 # tokens; unset uses model defaults
5151# tool_output_token_limit = 10000 # tokens stored per tool output; default: 10000 for gpt-5.2-codex# tool_output_token_limit = 12000 # tokens stored per tool output
52# model_catalog_json = "/absolute/path/to/models.json" # optional startup-only model catalog override52# model_catalog_json = "/absolute/path/to/models.json" # optional startup-only model catalog override
53# background_terminal_max_timeout = 300000 # ms; max empty write_stdin poll window (default 5m)53# background_terminal_max_timeout = 300000 # ms; max empty write_stdin poll window (default 5m)
54# log_dir = "/absolute/path/to/codex-logs" # directory for Codex logs; default: "$CODEX_HOME/log"54# log_dir = "/absolute/path/to/codex-logs" # directory for Codex logs; default: "$CODEX_HOME/log"
55# sqlite_home = "/absolute/path/to/codex-state" # optional SQLite-backed runtime state directory
55 56
56################################################################################57################################################################################
57# Reasoning & Verbosity (Responses API capable models)58# Reasoning & Verbosity (Responses API capable models)
58################################################################################59################################################################################
59 60
6061# Reasoning effort: minimal | low | medium | high | xhigh (default: medium; xhigh on gpt-5.2-codex and gpt-5.2)# Reasoning effort: minimal | low | medium | high | xhigh
6162model_reasoning_effort = "medium"# model_reasoning_effort = "medium"
63
64# Optional override used when Codex runs in plan mode: none | minimal | low | medium | high | xhigh
65# plan_mode_reasoning_effort = "high"
62 66
6367# Reasoning summary: auto | concise | detailed | none (default: auto)# Reasoning summary: auto | concise | detailed | none
64# model_reasoning_summary = "auto"68# model_reasoning_summary = "auto"
65 69
6670# Text verbosity for GPT-5 family (Responses API): low | medium | high (default: medium)# Text verbosity for GPT-5 family (Responses API): low | medium | high
67# model_verbosity = "medium"71# model_verbosity = "medium"
68 72
6973# Force enable or disable reasoning summaries for current model# Force enable or disable reasoning summaries for current model.
70# model_supports_reasoning_summaries = true74# model_supports_reasoning_summaries = true
71 75
72################################################################################76################################################################################
76# Additional user instructions are injected before AGENTS.md. Default: unset.80# Additional user instructions are injected before AGENTS.md. Default: unset.
77# developer_instructions = ""81# developer_instructions = ""
78 82
79# (Ignored) Optional legacy base instructions override (prefer AGENTS.md). Default: unset.
80# instructions = ""
81
82# Inline override for the history compaction prompt. Default: unset.83# Inline override for the history compaction prompt. Default: unset.
83# compact_prompt = ""84# compact_prompt = ""
84 85
86# Override the default commit co-author trailer. Set to "" to disable it.
87# commit_attribution = "Jane Doe <jane@example.com>"
88
85# Override built-in base instructions with a file path. Default: unset.89# Override built-in base instructions with a file path. Default: unset.
86# model_instructions_file = "/absolute/or/relative/path/to/instructions.txt"90# model_instructions_file = "/absolute/or/relative/path/to/instructions.txt"
87 91
88# Migration note: experimental_instructions_file was renamed to model_instructions_file (deprecated).
89
90# Load the compact prompt override from a file. Default: unset.92# Load the compact prompt override from a file. Default: unset.
91# experimental_compact_prompt_file = "/absolute/or/relative/path/to/compact_prompt.txt"93# experimental_compact_prompt_file = "/absolute/or/relative/path/to/compact_prompt.txt"
92 94
93# Legacy name for apply_patch_freeform. Default: false
94include_apply_patch_tool = false
95
96################################################################################95################################################################################
97# Notifications96# Notifications
98################################################################################97################################################################################
99 98
100# External notifier program (argv array). When unset: disabled.99# External notifier program (argv array). When unset: disabled.
101100# Example: notify = ["notify-send", "Codex"]# notify = ["notify-send", "Codex"]
102notify = [ ]
103 101
104################################################################################102################################################################################
105# Approval & Sandbox103# Approval & Sandbox
109# - untrusted: only known-safe read-only commands auto-run; others prompt107# - untrusted: only known-safe read-only commands auto-run; others prompt
110# - on-request: model decides when to ask (default)108# - on-request: model decides when to ask (default)
111# - never: never prompt (risky)109# - never: never prompt (risky)
112110# - { reject = { ... } }: auto-reject selected prompt categories# - { granular = { ... } }: allow or auto-reject selected prompt categories
113approval_policy = "on-request"111approval_policy = "on-request"
114112# Example granular auto-reject policy:# Example granular policy:
115113# approval_policy = { reject = { sandbox_approval = true, rules = false, mcp_elicitations = false } }# approval_policy = { granular = {
114# sandbox_approval = true,
115# rules = true,
116# mcp_elicitations = true,
117# request_permissions = false,
118# skill_approval = false
119# } }
116 120
117# Allow login-shell semantics for shell-based tools when they request `login = true`.121# Allow login-shell semantics for shell-based tools when they request `login = true`.
118# Default: true. Set false to force non-login shells and reject explicit login-shell requests.122# Default: true. Set false to force non-login shells and reject explicit login-shell requests.
131# Where to persist CLI login credentials: file (default) | keyring | auto135# Where to persist CLI login credentials: file (default) | keyring | auto
132cli_auth_credentials_store = "file"136cli_auth_credentials_store = "file"
133 137
134138# Base URL for ChatGPT auth flow (not OpenAI API). Default:# Base URL for ChatGPT auth flow (not OpenAI API).
135chatgpt_base_url = "https://chatgpt.com/backend-api/"139chatgpt_base_url = "https://chatgpt.com/backend-api/"
136 140
141# Optional base URL override for the built-in OpenAI provider.
142# openai_base_url = "https://us.api.openai.com/v1"
143
137# Restrict ChatGPT login to a specific workspace id. Default: unset.144# Restrict ChatGPT login to a specific workspace id. Default: unset.
138145# forced_chatgpt_workspace_id = ""# forced_chatgpt_workspace_id = "00000000-0000-0000-0000-000000000000"
139 146
140# Force login mechanism when Codex would normally auto-select. Default: unset.147# Force login mechanism when Codex would normally auto-select. Default: unset.
141# Allowed values: chatgpt | api148# Allowed values: chatgpt | api
200# If you use --yolo or another full access sandbox setting, web search defaults to live.205# If you use --yolo or another full access sandbox setting, web search defaults to live.
201web_search = "cached"206web_search = "cached"
202 207
203################################################################################
204# Profiles (named presets)
205################################################################################
206
207# Active profile name. When unset, no profile is applied.208# Active profile name. When unset, no profile is applied.
208# profile = "default"209# profile = "default"
209 210
211# Suppress the warning shown when under-development feature flags are enabled.
212# suppress_unstable_features_warning = true
213
210################################################################################214################################################################################
211# Agents (multi-agent roles and limits)215# Agents (multi-agent roles and limits)
212################################################################################216################################################################################
213 217
214218# [agents][agents]
215# Maximum concurrently open agent threads. Default: 6219# Maximum concurrently open agent threads. Default: 6
216# max_threads = 6220# max_threads = 6
217# Maximum nested spawn depth. Root session starts at depth 0. Default: 1221# Maximum nested spawn depth. Root session starts at depth 0. Default: 1
218# max_depth = 1222# max_depth = 1
223# Default timeout per worker for spawn_agents_on_csv jobs. When unset, the tool defaults to 1800 seconds.
224# job_max_runtime_seconds = 1800
219 225
220# [agents.reviewer]226# [agents.reviewer]
221227# description = "Find security, correctness, and test risks in code."# description = "Find correctness, security, and test risks in code."
222# config_file = "./agents/reviewer.toml" # relative to the config.toml that defines it228# config_file = "./agents/reviewer.toml" # relative to the config.toml that defines it
229# nickname_candidates = ["Athena", "Ada"]
223 230
224################################################################################231################################################################################
225# Skills (per-skill overrides)232# Skills (per-skill overrides)
227 234
228# Disable or re-enable a specific skill without deleting it.235# Disable or re-enable a specific skill without deleting it.
229[[skills.config]]236[[skills.config]]
230237# path = "/path/to/skill"# path = "/path/to/skill/SKILL.md"
231# enabled = false238# enabled = false
232 239
233################################################################################
234# Experimental toggles (legacy; prefer [features])
235################################################################################
236
237experimental_use_unified_exec_tool = false
238
239# Include apply_patch via freeform editing path (affects default tool set). Default: false
240experimental_use_freeform_apply_patch = false
241
242################################################################################240################################################################################
243# Sandbox settings (tables)241# Sandbox settings (tables)
244################################################################################242################################################################################
261[shell_environment_policy]259[shell_environment_policy]
262# inherit: all (default) | core | none260# inherit: all (default) | core | none
263inherit = "all"261inherit = "all"
264262# Skip default excludes for names containing KEY/SECRET/TOKEN (case-insensitive). Default: true# Skip default excludes for names containing KEY/SECRET/TOKEN (case-insensitive). Default: false
265263ignore_default_excludes = trueignore_default_excludes = false
266# Case-insensitive glob patterns to remove (e.g., "AWS_*", "AZURE_*"). Default: []264# Case-insensitive glob patterns to remove (e.g., "AWS_*", "AZURE_*"). Default: []
267exclude = []265exclude = []
268# Explicit key/value overrides (always win). Default: {}266# Explicit key/value overrides (always win). Default: {}
272# Experimental: run via user shell profile. Default: false270# Experimental: run via user shell profile. Default: false
273experimental_use_profile = false271experimental_use_profile = false
274 272
273################################################################################
274# Managed network proxy settings
275################################################################################
276
277[permissions.network]
278# enabled = true
279# proxy_url = "http://127.0.0.1:43128"
280# admin_url = "http://127.0.0.1:43129"
281# enable_socks5 = false
282# socks_url = "http://127.0.0.1:43130"
283# enable_socks5_udp = false
284# allow_upstream_proxy = false
285# dangerously_allow_non_loopback_proxy = false
286# dangerously_allow_non_loopback_admin = false
287# dangerously_allow_all_unix_sockets = false
288# mode = "limited" # limited | full
289# allowed_domains = ["api.openai.com"]
290# denied_domains = ["example.com"]
291# allow_unix_sockets = ["/var/run/docker.sock"]
292# allow_local_binding = false
293
275################################################################################294################################################################################
276# History (table)295# History (table)
277################################################################################296################################################################################
280# save-all (default) | none299# save-all (default) | none
281persistence = "save-all"300persistence = "save-all"
282# Maximum bytes for history file; oldest entries are trimmed when exceeded. Example: 5242880301# Maximum bytes for history file; oldest entries are trimmed when exceeded. Example: 5242880
283302# max_bytes = 0# max_bytes = 5242880
284 303
285################################################################################304################################################################################
286# UI, Notifications, and Misc (tables)305# UI, Notifications, and Misc (tables)
312# You can also add custom .tmTheme files under $CODEX_HOME/themes.331# You can also add custom .tmTheme files under $CODEX_HOME/themes.
313# theme = "catppuccin-mocha"332# theme = "catppuccin-mocha"
314 333
334# Internal tooltip state keyed by model slug. Usually managed by Codex.
335# [tui.model_availability_nux]
336# "gpt-5.4" = 1
337
338# Enable or disable analytics for this machine. When unset, Codex uses its default behavior.
339[analytics]
340enabled = true
341
315# Control whether users can submit feedback from `/feedback`. Default: true342# Control whether users can submit feedback from `/feedback`. Default: true
316[feedback]343[feedback]
317enabled = true344enabled = true
325# "hide_gpt-5.1-codex-max_migration_prompt" = true352# "hide_gpt-5.1-codex-max_migration_prompt" = true
326# model_migrations = { "gpt-4.1" = "gpt-5.1" }353# model_migrations = { "gpt-4.1" = "gpt-5.1" }
327 354
328# Suppress the warning shown when under-development feature flags are enabled.
329# suppress_unstable_features_warning = true
330
331################################################################################355################################################################################
332# Centralized Feature Flags (preferred)356# Centralized Feature Flags (preferred)
333################################################################################357################################################################################
336# Leave this table empty to accept defaults. Set explicit booleans to opt in/out.360# Leave this table empty to accept defaults. Set explicit booleans to opt in/out.
337# shell_tool = true361# shell_tool = true
338# apps = false362# apps = false
339363# apps_mcp_gateway = false# codex_hooks = false
340364# web_search_cached = false# unified_exec = true
341365# web_search_request = false# shell_snapshot = true
342366# unified_exec = false# multi_agent = true
343# shell_snapshot = false
344# apply_patch_freeform = false
345# multi_agent = false
346# search_tool = false
347# personality = true367# personality = true
348368# request_rule = true# fast_mode = true
349369# collaboration_modes = true# smart_approvals = false
350370# use_linux_sandbox_bwrap = false# enable_request_compression = true
351371# remote_models = false# skill_mcp_dependency_install = true
352372# runtime_metrics = false# prevent_idle_sleep = false
353# powershell_utf8 = true
354# child_agents_md = false
355 373
356################################################################################374################################################################################
357# Define MCP servers under this table. Leave empty to disable.375# Define MCP servers under this table. Leave empty to disable.
373# tool_timeout_sec = 60.0 # optional; default 60.0 seconds391# tool_timeout_sec = 60.0 # optional; default 60.0 seconds
374# enabled_tools = ["search", "summarize"] # optional allow-list392# enabled_tools = ["search", "summarize"] # optional allow-list
375# disabled_tools = ["slow-tool"] # optional deny-list (applied after allow-list)393# disabled_tools = ["slow-tool"] # optional deny-list (applied after allow-list)
394# scopes = ["read:docs"] # optional OAuth scopes
395# oauth_resource = "https://docs.example.com/" # optional OAuth resource
376 396
377# --- Example: Streamable HTTP transport ---397# --- Example: Streamable HTTP transport ---
378# [mcp_servers.github]398# [mcp_servers.github]
385# startup_timeout_sec = 10.0 # optional405# startup_timeout_sec = 10.0 # optional
386# tool_timeout_sec = 60.0 # optional406# tool_timeout_sec = 60.0 # optional
387# enabled_tools = ["list_issues"] # optional allow-list407# enabled_tools = ["list_issues"] # optional allow-list
408# disabled_tools = ["delete_issue"] # optional deny-list
409# scopes = ["repo"] # optional OAuth scopes
388 410
389################################################################################411################################################################################
390# Model Providers412# Model Providers
391################################################################################413################################################################################
392 414
393# Built-ins include:415# Built-ins include:
394416# - openai (Responses API; requires login or OPENAI_API_KEY via auth flow)# - openai
395417# - oss (Chat Completions API; defaults to http://localhost:11434/v1)# - ollama
418# - lmstudio
396 419
397[model_providers]420[model_providers]
398 421
400# [model_providers.openaidr]423# [model_providers.openaidr]
401# name = "OpenAI Data Residency"424# name = "OpenAI Data Residency"
402# base_url = "https://us.api.openai.com/v1" # example with 'us' domain prefix425# base_url = "https://us.api.openai.com/v1" # example with 'us' domain prefix
403426# wire_api = "responses" # "responses" | "chat" (default varies)# wire_api = "responses" # only supported value
404# # requires_openai_auth = true # built-in OpenAI defaults to true427# # requires_openai_auth = true # built-in OpenAI defaults to true
405# # request_max_retries = 4 # default 4; max 100428# # request_max_retries = 4 # default 4; max 100
406# # stream_max_retries = 5 # default 5; max 100429# # stream_max_retries = 5 # default 5; max 100
407# # stream_idle_timeout_ms = 300000 # default 300_000 (5m)430# # stream_idle_timeout_ms = 300000 # default 300_000 (5m)
431# # supports_websockets = true # optional
408# # experimental_bearer_token = "sk-example" # optional dev-only direct bearer token432# # experimental_bearer_token = "sk-example" # optional dev-only direct bearer token
409# # http_headers = { "X-Example" = "value" }433# # http_headers = { "X-Example" = "value" }
410# # env_http_headers = { "OpenAI-Organization" = "OPENAI_ORGANIZATION", "OpenAI-Project" = "OPENAI_PROJECT" }434# # env_http_headers = { "OpenAI-Organization" = "OPENAI_ORGANIZATION", "OpenAI-Project" = "OPENAI_PROJECT" }
411 435
412436# --- Example: Azure (Chat/Responses depending on endpoint) ---# --- Example: Azure/OpenAI-compatible provider ---
413# [model_providers.azure]437# [model_providers.azure]
414# name = "Azure"438# name = "Azure"
415# base_url = "https://YOUR_PROJECT_NAME.openai.azure.com/openai"439# base_url = "https://YOUR_PROJECT_NAME.openai.azure.com/openai"
416440# wire_api = "responses" # or "chat" per endpoint# wire_api = "responses"
417# query_params = { api-version = "2025-04-01-preview" }441# query_params = { api-version = "2025-04-01-preview" }
418# env_key = "AZURE_OPENAI_API_KEY"442# env_key = "AZURE_OPENAI_API_KEY"
419443# # env_key_instructions = "Set AZURE_OPENAI_API_KEY in your environment"# env_key_instructions = "Set AZURE_OPENAI_API_KEY in your environment"
444# # supports_websockets = false
420 445
421# --- Example: Local OSS (e.g., Ollama-compatible) ---446# --- Example: Local OSS (e.g., Ollama-compatible) ---
422# [model_providers.ollama]447# [model_providers.ollama]
423# name = "Ollama"448# name = "Ollama"
424# base_url = "http://localhost:11434/v1"449# base_url = "http://localhost:11434/v1"
425450# wire_api = "chat"# wire_api = "responses"
426
427################################################################################
428# Profiles (named presets)
429################################################################################
430
431[profiles]
432
433# [profiles.default]
434# model = "gpt-5.2-codex"
435# model_provider = "openai"
436# approval_policy = "on-request"
437# sandbox_mode = "read-only"
438# oss_provider = "ollama"
439# model_reasoning_effort = "medium"
440# model_reasoning_summary = "auto"
441# model_verbosity = "medium"
442# personality = "friendly" # or "pragmatic" or "none"
443# chatgpt_base_url = "https://chatgpt.com/backend-api/"
444# model_catalog_json = "./models.json"
445# experimental_compact_prompt_file = "./compact_prompt.txt"
446# include_apply_patch_tool = false
447# experimental_use_unified_exec_tool = false
448# experimental_use_freeform_apply_patch = false
449# tools.web_search = false # deprecated legacy alias; prefer top-level `web_search`
450# features = { unified_exec = false }
451 451
452################################################################################452################################################################################
453# Apps / Connectors453# Apps / Connectors
471# enabled = false471# enabled = false
472# approval_mode = "approve"472# approval_mode = "approve"
473 473
474################################################################################
475# Profiles (named presets)
476################################################################################
477
478[profiles]
479
480# [profiles.default]
481# model = "gpt-5.4"
482# model_provider = "openai"
483# approval_policy = "on-request"
484# sandbox_mode = "read-only"
485# service_tier = "flex"
486# oss_provider = "ollama"
487# model_reasoning_effort = "medium"
488# plan_mode_reasoning_effort = "high"
489# model_reasoning_summary = "auto"
490# model_verbosity = "medium"
491# personality = "pragmatic" # or "friendly" or "none"
492# chatgpt_base_url = "https://chatgpt.com/backend-api/"
493# model_catalog_json = "./models.json"
494# model_instructions_file = "/absolute/or/relative/path/to/instructions.txt"
495# experimental_compact_prompt_file = "./compact_prompt.txt"
496# tools_view_image = true
497# features = { unified_exec = false }
498
474################################################################################499################################################################################
475# Projects (trust levels)500# Projects (trust levels)
476################################################################################501################################################################################
477 502
478# Mark specific worktrees as trusted or untrusted.
479[projects]503[projects]
504# Mark specific worktrees as trusted or untrusted.
480# [projects."/absolute/path/to/project"]505# [projects."/absolute/path/to/project"]
481# trust_level = "trusted" # or "untrusted"506# trust_level = "trusted" # or "untrusted"
482 507
508################################################################################
509# Tools
510################################################################################
511
512[tools]
513# view_image = true
514
483################################################################################515################################################################################
484# OpenTelemetry (OTEL) - disabled by default516# OpenTelemetry (OTEL) - disabled by default
485################################################################################517################################################################################
493exporter = "none"525exporter = "none"
494# Trace exporter: none (default) | otlp-http | otlp-grpc526# Trace exporter: none (default) | otlp-http | otlp-grpc
495trace_exporter = "none"527trace_exporter = "none"
528# Metrics exporter: none | statsig | otlp-http | otlp-grpc
529metrics_exporter = "statsig"
496 530
497# Example OTLP/HTTP exporter configuration531# Example OTLP/HTTP exporter configuration
498# [otel.exporter."otlp-http"]532# [otel.exporter."otlp-http"]
502# [otel.exporter."otlp-http".headers]536# [otel.exporter."otlp-http".headers]
503# "x-otlp-api-key" = "${OTLP_TOKEN}"537# "x-otlp-api-key" = "${OTLP_TOKEN}"
504 538
505# Example OTLP/gRPC exporter configuration
506# [otel.exporter."otlp-grpc"]
507# endpoint = "https://otel.example.com:4317",
508# headers = { "x-otlp-meta" = "abc123" }
509
510# Example OTLP exporter with mutual TLS
511# [otel.exporter."otlp-http"]
512# endpoint = "https://otel.example.com/v1/logs"
513# protocol = "binary"
514
515# [otel.exporter."otlp-http".headers]
516# "x-otlp-api-key" = "${OTLP_TOKEN}"
517
518# [otel.exporter."otlp-http".tls]539# [otel.exporter."otlp-http".tls]
519# ca-certificate = "certs/otel-ca.pem"540# ca-certificate = "certs/otel-ca.pem"
520# client-certificate = "/etc/codex/certs/client.pem"541# client-certificate = "/etc/codex/certs/client.pem"
521# client-private-key = "/etc/codex/certs/client-key.pem"542# client-private-key = "/etc/codex/certs/client-key.pem"
522```
523 543
524544################################################################################# Example OTLP/gRPC trace exporter configuration
545# [otel.trace_exporter."otlp-grpc"]
546# endpoint = "https://otel.example.com:4317"
547# headers = { "x-otlp-meta" = "abc123" }
525 548
549################################################################################
526# Windows550# Windows
527
528################################################################################551################################################################################
529 552
530[windows]553[windows]
531
532# Native Windows sandbox mode (Windows only): unelevated | elevated554# Native Windows sandbox mode (Windows only): unelevated | elevated
533
534sandbox = "unelevated"555sandbox = "unelevated"
556```