aboutsummaryrefslogtreecommitdiff
path: root/docs/next/website
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
parentb660cad80450147610091e0e5758faa6276e5983 (diff)
feat: make headless terminal size configurable (#2829)
refs #2828
Diffstat (limited to 'docs/next/website')
-rw-r--r--docs/next/website/src/content/docs/configuration.mdx12
-rw-r--r--docs/next/website/src/data/config-reference.json18
2 files changed, 30 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:
diff --git a/docs/next/website/src/data/config-reference.json b/docs/next/website/src/data/config-reference.json
index c16db7a1..a2f8d7a1 100644
--- a/docs/next/website/src/data/config-reference.json
+++ b/docs/next/website/src/data/config-reference.json
@@ -13,6 +13,24 @@
]
},
{
+ "id": "server",
+ "title": "Server",
+ "keys": [
+ {
+ "key": "server.headless_cols",
+ "type": "integer",
+ "default": "120",
+ "description": "Virtual terminal width used for layout and newly created panes when no client is attached. Must be greater than zero."
+ },
+ {
+ "key": "server.headless_rows",
+ "type": "integer",
+ "default": "40",
+ "description": "Virtual terminal height used for layout and newly created panes when no client is attached. Must be greater than zero."
+ }
+ ]
+ },
+ {
"id": "theme",
"title": "Theme",
"keys": [