config-sample.md +144 −127
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"
58# Reasoning & Verbosity (Responses API capable models)58# Reasoning & Verbosity (Responses API capable models)
59################################################################################59################################################################################
60 60
6161# 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
6262model_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"
63 66
6467# Reasoning summary: auto | concise | detailed | none (default: auto)# Reasoning summary: auto | concise | detailed | none
65# model_reasoning_summary = "auto"68# model_reasoning_summary = "auto"
66 69
6770# Text verbosity for GPT-5 family (Responses API): low | medium | high (default: medium)# Text verbosity for GPT-5 family (Responses API): low | medium | high
68# model_verbosity = "medium"71# model_verbosity = "medium"
69 72
7073# Force enable or disable reasoning summaries for current model# Force enable or disable reasoning summaries for current model.
71# model_supports_reasoning_summaries = true74# model_supports_reasoning_summaries = true
72 75
73################################################################################76################################################################################
77# Additional user instructions are injected before AGENTS.md. Default: unset.80# Additional user instructions are injected before AGENTS.md. Default: unset.
78# developer_instructions = ""81# developer_instructions = ""
79 82
80# (Ignored) Optional legacy base instructions override (prefer AGENTS.md). Default: unset.
81# instructions = ""
82
83# Inline override for the history compaction prompt. Default: unset.83# Inline override for the history compaction prompt. Default: unset.
84# compact_prompt = ""84# compact_prompt = ""
85 85
86# Override the default commit co-author trailer. Set to "" to disable it.
87# commit_attribution = "Jane Doe <jane@example.com>"
88
86# Override built-in base instructions with a file path. Default: unset.89# Override built-in base instructions with a file path. Default: unset.
87# model_instructions_file = "/absolute/or/relative/path/to/instructions.txt"90# model_instructions_file = "/absolute/or/relative/path/to/instructions.txt"
88 91
89# Migration note: experimental_instructions_file was renamed to model_instructions_file (deprecated).
90
91# Load the compact prompt override from a file. Default: unset.92# Load the compact prompt override from a file. Default: unset.
92# 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"
93 94
94# Legacy name for apply_patch_freeform. Default: false
95include_apply_patch_tool = false
96
97################################################################################95################################################################################
98# Notifications96# Notifications
99################################################################################97################################################################################
100 98
101# External notifier program (argv array). When unset: disabled.99# External notifier program (argv array). When unset: disabled.
102100# Example: notify = ["notify-send", "Codex"]# notify = ["notify-send", "Codex"]
103notify = [ ]
104 101
105################################################################################102################################################################################
106# Approval & Sandbox103# Approval & Sandbox
110# - untrusted: only known-safe read-only commands auto-run; others prompt107# - untrusted: only known-safe read-only commands auto-run; others prompt
111# - on-request: model decides when to ask (default)108# - on-request: model decides when to ask (default)
112# - never: never prompt (risky)109# - never: never prompt (risky)
113110# - { reject = { ... } }: auto-reject selected prompt categories# - { granular = { ... } }: allow or auto-reject selected prompt categories
114approval_policy = "on-request"111approval_policy = "on-request"
115112# Example granular auto-reject policy:# Example granular policy:
116113# 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# } }
117 120
118# 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`.
119# 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.
125# - danger-full-access (no sandbox; extremely risky)128# - danger-full-access (no sandbox; extremely risky)
126sandbox_mode = "read-only"129sandbox_mode = "read-only"
127 130
128[windows]
129# Native Windows sandbox mode (Windows only): unelevated | elevated
130sandbox = "unelevated"
131
132################################################################################131################################################################################
133# Authentication & Login132# Authentication & Login
134################################################################################133################################################################################
136# Where to persist CLI login credentials: file (default) | keyring | auto135# Where to persist CLI login credentials: file (default) | keyring | auto
137cli_auth_credentials_store = "file"136cli_auth_credentials_store = "file"
138 137
139138# Base URL for ChatGPT auth flow (not OpenAI API). Default:# Base URL for ChatGPT auth flow (not OpenAI API).
140chatgpt_base_url = "https://chatgpt.com/backend-api/"139chatgpt_base_url = "https://chatgpt.com/backend-api/"
141 140
141# Optional base URL override for the built-in OpenAI provider.
142# openai_base_url = "https://us.api.openai.com/v1"
143
142# Restrict ChatGPT login to a specific workspace id. Default: unset.144# Restrict ChatGPT login to a specific workspace id. Default: unset.
143145# forced_chatgpt_workspace_id = ""# forced_chatgpt_workspace_id = "00000000-0000-0000-0000-000000000000"
144 146
145# Force login mechanism when Codex would normally auto-select. Default: unset.147# Force login mechanism when Codex would normally auto-select. Default: unset.
146# Allowed values: chatgpt | api148# Allowed values: chatgpt | api
205# 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.
206web_search = "cached"206web_search = "cached"
207 207
208################################################################################
209# Profiles (named presets)
210################################################################################
211
212# Active profile name. When unset, no profile is applied.208# Active profile name. When unset, no profile is applied.
213# profile = "default"209# profile = "default"
214 210
211# Suppress the warning shown when under-development feature flags are enabled.
212# suppress_unstable_features_warning = true
213
215################################################################################214################################################################################
216# Agents (multi-agent roles and limits)215# Agents (multi-agent roles and limits)
217################################################################################216################################################################################
218 217
219218# [agents][agents]
220# Maximum concurrently open agent threads. Default: 6219# Maximum concurrently open agent threads. Default: 6
221# max_threads = 6220# max_threads = 6
222# Maximum nested spawn depth. Root session starts at depth 0. Default: 1221# Maximum nested spawn depth. Root session starts at depth 0. Default: 1
225# job_max_runtime_seconds = 1800224# job_max_runtime_seconds = 1800
226 225
227# [agents.reviewer]226# [agents.reviewer]
228227# description = "Find security, correctness, and test risks in code."# description = "Find correctness, security, and test risks in code."
229# 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"]
230 230
231################################################################################231################################################################################
232# Skills (per-skill overrides)232# Skills (per-skill overrides)
237# path = "/path/to/skill/SKILL.md"237# path = "/path/to/skill/SKILL.md"
238# enabled = false238# enabled = false
239 239
240################################################################################
241# Experimental toggles (legacy; prefer [features])
242################################################################################
243
244experimental_use_unified_exec_tool = false
245
246# Include apply_patch via freeform editing path (affects default tool set). Default: false
247experimental_use_freeform_apply_patch = false
248
249################################################################################240################################################################################
250# Sandbox settings (tables)241# Sandbox settings (tables)
251################################################################################242################################################################################
268[shell_environment_policy]259[shell_environment_policy]
269# inherit: all (default) | core | none260# inherit: all (default) | core | none
270inherit = "all"261inherit = "all"
271262# 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
272263ignore_default_excludes = trueignore_default_excludes = false
273# Case-insensitive glob patterns to remove (e.g., "AWS_*", "AZURE_*"). Default: []264# Case-insensitive glob patterns to remove (e.g., "AWS_*", "AZURE_*"). Default: []
274exclude = []265exclude = []
275# Explicit key/value overrides (always win). Default: {}266# Explicit key/value overrides (always win). Default: {}
279# Experimental: run via user shell profile. Default: false270# Experimental: run via user shell profile. Default: false
280experimental_use_profile = false271experimental_use_profile = false
281 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
282################################################################################294################################################################################
283# History (table)295# History (table)
284################################################################################296################################################################################
287# save-all (default) | none299# save-all (default) | none
288persistence = "save-all"300persistence = "save-all"
289# 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
290302# max_bytes = 0# max_bytes = 5242880
291 303
292################################################################################304################################################################################
293# UI, Notifications, and Misc (tables)305# UI, Notifications, and Misc (tables)
319# You can also add custom .tmTheme files under $CODEX_HOME/themes.331# You can also add custom .tmTheme files under $CODEX_HOME/themes.
320# theme = "catppuccin-mocha"332# theme = "catppuccin-mocha"
321 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
322# Control whether users can submit feedback from `/feedback`. Default: true342# Control whether users can submit feedback from `/feedback`. Default: true
323[feedback]343[feedback]
324enabled = true344enabled = true
332# "hide_gpt-5.1-codex-max_migration_prompt" = true352# "hide_gpt-5.1-codex-max_migration_prompt" = true
333# model_migrations = { "gpt-4.1" = "gpt-5.1" }353# model_migrations = { "gpt-4.1" = "gpt-5.1" }
334 354
335# Suppress the warning shown when under-development feature flags are enabled.
336# suppress_unstable_features_warning = true
337
338################################################################################355################################################################################
339# Centralized Feature Flags (preferred)356# Centralized Feature Flags (preferred)
340################################################################################357################################################################################
343# 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.
344# shell_tool = true361# shell_tool = true
345# apps = false362# apps = false
346363# apps_mcp_gateway = false# codex_hooks = false
347364# web_search_cached = false# unified_exec = true
348365# web_search_request = false# shell_snapshot = true
349366# unified_exec = false# multi_agent = true
350# shell_snapshot = false
351# apply_patch_freeform = false
352# multi_agent = false
353# search_tool = false
354# personality = true367# personality = true
355368# request_rule = true# fast_mode = true
356369# collaboration_modes = true# smart_approvals = false
357370# use_linux_sandbox_bwrap = false# enable_request_compression = true
358371# remote_models = false# skill_mcp_dependency_install = true
359372# runtime_metrics = false# prevent_idle_sleep = false
360# powershell_utf8 = true
361# child_agents_md = false
362 373
363################################################################################374################################################################################
364# Define MCP servers under this table. Leave empty to disable.375# Define MCP servers under this table. Leave empty to disable.
380# tool_timeout_sec = 60.0 # optional; default 60.0 seconds391# tool_timeout_sec = 60.0 # optional; default 60.0 seconds
381# enabled_tools = ["search", "summarize"] # optional allow-list392# enabled_tools = ["search", "summarize"] # optional allow-list
382# 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
383 396
384# --- Example: Streamable HTTP transport ---397# --- Example: Streamable HTTP transport ---
385# [mcp_servers.github]398# [mcp_servers.github]
392# startup_timeout_sec = 10.0 # optional405# startup_timeout_sec = 10.0 # optional
393# tool_timeout_sec = 60.0 # optional406# tool_timeout_sec = 60.0 # optional
394# 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
395 410
396################################################################################411################################################################################
397# Model Providers412# Model Providers
398################################################################################413################################################################################
399 414
400# Built-ins include:415# Built-ins include:
401416# - openai (Responses API; requires login or OPENAI_API_KEY via auth flow)# - openai
402417# - oss (Chat Completions API; defaults to http://localhost:11434/v1)# - ollama
418# - lmstudio
403 419
404[model_providers]420[model_providers]
405 421
407# [model_providers.openaidr]423# [model_providers.openaidr]
408# name = "OpenAI Data Residency"424# name = "OpenAI Data Residency"
409# 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
410426# wire_api = "responses" # "responses" | "chat" (default varies)# wire_api = "responses" # only supported value
411# # requires_openai_auth = true # built-in OpenAI defaults to true427# # requires_openai_auth = true # built-in OpenAI defaults to true
412# # request_max_retries = 4 # default 4; max 100428# # request_max_retries = 4 # default 4; max 100
413# # stream_max_retries = 5 # default 5; max 100429# # stream_max_retries = 5 # default 5; max 100
414# # stream_idle_timeout_ms = 300000 # default 300_000 (5m)430# # stream_idle_timeout_ms = 300000 # default 300_000 (5m)
431# # supports_websockets = true # optional
415# # experimental_bearer_token = "sk-example" # optional dev-only direct bearer token432# # experimental_bearer_token = "sk-example" # optional dev-only direct bearer token
416# # http_headers = { "X-Example" = "value" }433# # http_headers = { "X-Example" = "value" }
417# # env_http_headers = { "OpenAI-Organization" = "OPENAI_ORGANIZATION", "OpenAI-Project" = "OPENAI_PROJECT" }434# # env_http_headers = { "OpenAI-Organization" = "OPENAI_ORGANIZATION", "OpenAI-Project" = "OPENAI_PROJECT" }
418 435
419436# --- Example: Azure (Chat/Responses depending on endpoint) ---# --- Example: Azure/OpenAI-compatible provider ---
420# [model_providers.azure]437# [model_providers.azure]
421# name = "Azure"438# name = "Azure"
422# base_url = "https://YOUR_PROJECT_NAME.openai.azure.com/openai"439# base_url = "https://YOUR_PROJECT_NAME.openai.azure.com/openai"
423440# wire_api = "responses" # or "chat" per endpoint# wire_api = "responses"
424# query_params = { api-version = "2025-04-01-preview" }441# query_params = { api-version = "2025-04-01-preview" }
425# env_key = "AZURE_OPENAI_API_KEY"442# env_key = "AZURE_OPENAI_API_KEY"
426443# # 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
427 445
428# --- Example: Local OSS (e.g., Ollama-compatible) ---446# --- Example: Local OSS (e.g., Ollama-compatible) ---
429# [model_providers.ollama]447# [model_providers.ollama]
430# name = "Ollama"448# name = "Ollama"
431# base_url = "http://localhost:11434/v1"449# base_url = "http://localhost:11434/v1"
432450# wire_api = "chat"# wire_api = "responses"
433
434################################################################################
435# Profiles (named presets)
436################################################################################
437
438[profiles]
439
440# [profiles.default]
441# model = "gpt-5.2-codex"
442# model_provider = "openai"
443# approval_policy = "on-request"
444# sandbox_mode = "read-only"
445# oss_provider = "ollama"
446# model_reasoning_effort = "medium"
447# model_reasoning_summary = "auto"
448# model_verbosity = "medium"
449# personality = "friendly" # or "pragmatic" or "none"
450# chatgpt_base_url = "https://chatgpt.com/backend-api/"
451# model_catalog_json = "./models.json"
452# experimental_compact_prompt_file = "./compact_prompt.txt"
453# include_apply_patch_tool = false
454# experimental_use_unified_exec_tool = false
455# experimental_use_freeform_apply_patch = false
456# tools.web_search = false # deprecated legacy alias; prefer top-level `web_search`
457# features = { unified_exec = false }
458 451
459################################################################################452################################################################################
460# Apps / Connectors453# Apps / Connectors
478# enabled = false471# enabled = false
479# approval_mode = "approve"472# approval_mode = "approve"
480 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
481################################################################################499################################################################################
482# Projects (trust levels)500# Projects (trust levels)
483################################################################################501################################################################################
484 502
485# Mark specific worktrees as trusted or untrusted.
486[projects]503[projects]
504# Mark specific worktrees as trusted or untrusted.
487# [projects."/absolute/path/to/project"]505# [projects."/absolute/path/to/project"]
488# trust_level = "trusted" # or "untrusted"506# trust_level = "trusted" # or "untrusted"
489 507
508################################################################################
509# Tools
510################################################################################
511
512[tools]
513# view_image = true
514
490################################################################################515################################################################################
491# OpenTelemetry (OTEL) - disabled by default516# OpenTelemetry (OTEL) - disabled by default
492################################################################################517################################################################################
500exporter = "none"525exporter = "none"
501# Trace exporter: none (default) | otlp-http | otlp-grpc526# Trace exporter: none (default) | otlp-http | otlp-grpc
502trace_exporter = "none"527trace_exporter = "none"
528# Metrics exporter: none | statsig | otlp-http | otlp-grpc
529metrics_exporter = "statsig"
503 530
504# Example OTLP/HTTP exporter configuration531# Example OTLP/HTTP exporter configuration
505# [otel.exporter."otlp-http"]532# [otel.exporter."otlp-http"]
509# [otel.exporter."otlp-http".headers]536# [otel.exporter."otlp-http".headers]
510# "x-otlp-api-key" = "${OTLP_TOKEN}"537# "x-otlp-api-key" = "${OTLP_TOKEN}"
511 538
512# Example OTLP/gRPC exporter configuration
513# [otel.exporter."otlp-grpc"]
514# endpoint = "https://otel.example.com:4317",
515# headers = { "x-otlp-meta" = "abc123" }
516
517# Example OTLP exporter with mutual TLS
518# [otel.exporter."otlp-http"]
519# endpoint = "https://otel.example.com/v1/logs"
520# protocol = "binary"
521
522# [otel.exporter."otlp-http".headers]
523# "x-otlp-api-key" = "${OTLP_TOKEN}"
524
525# [otel.exporter."otlp-http".tls]539# [otel.exporter."otlp-http".tls]
526# ca-certificate = "certs/otel-ca.pem"540# ca-certificate = "certs/otel-ca.pem"
527# client-certificate = "/etc/codex/certs/client.pem"541# client-certificate = "/etc/codex/certs/client.pem"
528# client-private-key = "/etc/codex/certs/client-key.pem"542# client-private-key = "/etc/codex/certs/client-key.pem"
529```
530 543
531544################################################################################# 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" }
532 548
549################################################################################
533# Windows550# Windows
534
535################################################################################551################################################################################
536 552
537[windows]553[windows]
538
539# Native Windows sandbox mode (Windows only): unelevated | elevated554# Native Windows sandbox mode (Windows only): unelevated | elevated
540
541sandbox = "unelevated"555sandbox = "unelevated"
556```