aboutsummaryrefslogtreecommitdiff
path: root/docs/next/website/src/content
diff options
context:
space:
mode:
authorCan Celik <ogulcancelik@gmail.com>2026-08-15 15:09:53 +0300
committerGitHub <noreply@github.com>2026-08-15 15:09:53 +0300
commit15539d3dec40bcc40e6f4bb0eaa4f073ad26b74f (patch)
tree2ff7cf0353d3c3228f32d5d7756b45ba2486edb2 /docs/next/website/src/content
parentb660cad80450147610091e0e5758faa6276e5983 (diff)
feat: make headless terminal size configurable (#2829)
refs #2828
Diffstat (limited to 'docs/next/website/src/content')
-rw-r--r--docs/next/website/src/content/docs/configuration.mdx12
1 files changed, 12 insertions, 0 deletions
diff --git a/docs/next/website/src/content/docs/configuration.mdx b/docs/next/website/src/content/docs/configuration.mdx
index 4ba3a07a..9f6a96f3 100644
--- a/docs/next/website/src/content/docs/configuration.mdx
+++ b/docs/next/website/src/content/docs/configuration.mdx
@@ -50,6 +50,18 @@ You can also open the global menu in Herdr and choose `reload config`.
Reload applies most UI settings without restarting panes. Startup-only settings still need a restart.
+## Headless terminal size
+
+When no client is attached, the server uses a 120×40 virtual terminal for layout and newly created panes. Change that fallback for headless orchestration with:
+
+```toml
+[server]
+headless_cols = 160
+headless_rows = 50
+```
+
+An attached client remains authoritative for the shared runtime size. After it detaches, existing pane PTYs retain their last attached size while new headless layout uses the configured fallback.
+
## Terminal defaults
Set the executable Herdr uses for newly created interactive panes: