Skip to content

armgit / ODS

Public Imported from GitHub
0

ODS V3 Pre-Release: Public testing and refinement ahead of the official V3 launch. Turn your PC, Mac, or Linux box into a private AI server.

144 KB
Raw Blame
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "ODS Environment Configuration",
  "description": "Schema for ODS .env file validation",
  "type": "object",
  "required": [
    "WEBUI_SECRET",
    "SEARXNG_SECRET",
    "N8N_USER",
    "N8N_PASS",
    "LITELLM_KEY"
  ],
  "properties": {
    "ODS_VERSION": {
      "type": "string",
      "description": "ODS version for update compatibility checks"
    },
    "ODS_MODE": {
      "type": "string",
      "description": "LLM backend mode: local, cloud or hybrid. AMD installs use local. lemonade is the retired name of the AMD local mode, accepted for one release; installer reruns and updates rewrite it to local.",
      "enum": [
        "local",
        "cloud",
        "hybrid",
        "lemonade"
      ],
      "default": "local"
    },
    "ODS_GATEWAY_ONLY": {
      "type": "string",
      "description": "Linux API-only external gateway selection persisted by the installer.",
      "enum": ["true", "false"],
      "default": "false"
    },
    "ENABLE_OPEN_WEBUI": {
      "type": "string",
      "description": "Whether the Linux gateway-only stack includes Open WebUI.",
      "enum": ["true", "false"],
      "default": "true"
    },
    "ENABLE_OPENCODE": {
      "type": "string",
      "description": "Native macOS installer OpenCode choice, saved before Pixel activation for retained-install continuation. Absence in older installations is not an opt-out.",
      "enum": ["true", "false"]
    },
    "ENABLE_DEVTOOLS": {
      "type": "string",
      "description": "Whether the Linux installer should install Claude Code and Codex CLI. Disabling preserves existing binaries.",
      "enum": ["true", "false"],
      "default": "false"
    },
    "ODS_MODEL_SWITCHBOARD": {
      "type": "string",
      "description": "Model Switchboard rollout mode. enabled routes supported consumers through the stable ods/current alias.",
      "enum": [
        "legacy",
        "observe",
        "enabled"
      ],
      "default": "enabled"
    },
    "ODS_MODEL_PROFILES": {
      "type": "string",
      "description": "Model profiles: the first time a model runs, ODS measures what it can do on this machine (answers, tool calls, thinking, images, speed). observe shows the result on the Models page; enabled also lets apps use it; off skips the check.",
      "enum": [
        "off",
        "observe",
        "enabled"
      ],
      "default": "observe"
    },
    "LLM_API_URL": {
      "type": "string",
      "description": "URL where all services send LLM requests",
      "default": "http://llama-server:8080"
    },
    "OPEN_WEBUI_LLM_BASE_URL": {
      "type": "string",
      "description": "Optional Open WebUI OpenAI-compatible chat base URL override. Enabled switchboard installs set this to the LiteLLM gateway."
    },
    "OPEN_WEBUI_LLM_API_KEY": {
      "type": "string",
      "description": "Optional Open WebUI chat API key. Enabled switchboard installs use the LiteLLM key.",
      "secret": true
    },
    "OPEN_WEBUI_TASK_MODEL": {
      "type": "string",
      "description": "Exact ordinary-model ID for Open WebUI background tasks when Pixel is the default conversation model. Direct llama.cpp installs derive this from GGUF_FILE when empty."
    },
    "LLM_URL": {
      "type": "string",
      "description": "LLM base URL used by dashboard-api functional diagnostics. Leave empty to follow LLM_API_URL inside the Docker network."
    },
    "REMOTE_LLM_ENABLED": {
      "type": "string",
      "description": "Explicit remote-provider switch. Remote routing is valid only with ODS_MODE=cloud.",
      "enum": [
        "",
        "true",
        "false"
      ],
      "default": "false"
    },
    "REMOTE_LLM_TRANSPORT": {
      "type": "string",
      "description": "Remote provider transport profile: direct HTTPS or SSH transport.",
      "enum": [
        "",
        "direct",
        "ssh"
      ],
      "default": ""
    },
    "REMOTE_LLM_BASE_URL": {
      "type": "string",
      "description": "Remote OpenAI-compatible provider API root. The renderer normalizes host roots to /v1."
    },
    "REMOTE_LLM_MODEL": {
      "type": "string",
      "description": "Concrete remote model ID advertised by the provider."
    },
    "REMOTE_LLM_TLS_CA_FILE": {
      "type": "string",
      "description": "Optional private CA path for the remote provider transport. CA material is not stored in .env."
    },
    "REMOTE_LLM_SSH_HOST": {
      "type": "string",
      "description": "Explicit SSH server host used by the remote provider transport."
    },
    "REMOTE_LLM_SSH_USER": {
      "type": "string",
      "description": "Explicit SSH user used by the remote provider transport."
    },
    "REMOTE_LLM_SSH_PORT": {
      "type": "integer",
      "description": "SSH server port used by the remote provider transport.",
      "minimum": 1,
      "maximum": 65535
    },
    "REMOTE_LLM_SSH_INFERENCE_HOST": {
      "type": "string",
      "description": "Inference address as seen from the SSH server for SSH transport."
    },
    "REMOTE_LLM_SSH_INFERENCE_PORT": {
      "type": "integer",
      "description": "Inference port as seen from the SSH server for SSH transport.",
      "minimum": 1,
      "maximum": 65535
    },
    "REMOTE_LLM_SSH_CONTROL_HOST": {
      "type": "string",
      "description": "Optional ODS peer-control address as seen from the SSH server."
    },
    "REMOTE_LLM_SSH_CONTROL_PORT": {
      "type": "integer",
      "description": "Optional ODS peer-control port as seen from the SSH server.",
      "minimum": 1,
      "maximum": 65535
    },
    "REMOTE_ODS_PEER_URL": {
      "type": "string",
      "description": "Optional paired ODS control-plane root for authenticated ODS peer lifecycle support."
    },
    "REMOTE_PROVIDER_DATA_GID": {
      "type": "integer",
      "description": "Numeric installation-owner data GID granted only to hardened remote-provider containers for mode-0640 lifecycle secret reads.",
      "minimum": 0,
      "maximum": 2147483647,
      "default": 1000
    },
    "LLM_BACKEND": {
      "type": "string",
      "description": "Inference backend. Current installers write llama-server (every local GPU, AMD included), external, or vllm: the vLLM engine (docker-compose.vllm.yml) instead of llama-server, which the Linux installer chooses when a vLLM catalog model fits one NVIDIA GPU, datacenter Blackwell or the RTX PRO 6000 class (install.sh --llm-backend vllm|llama-server overrides the choice). Legacy values such as lemonade and litellm remain accepted for upgrade compatibility.",
      "default": "llama-server"
    },
    "VLLM_IMAGE": {
      "type": "string",
      "description": "vLLM engine image for LLM_BACKEND=vllm: the digest-pinned reference recorded in config/dependency-lock.json. The installer writes it; docker-compose.vllm.yml defaults to the same pin."
    },
    "VLLM_MODEL_DIR": {
      "type": "string",
      "description": "Folder under data/models that holds the vLLM model snapshot, e.g. nvidia--GLM-5.3-Flash-NVFP4@da920bb0. Mounted read-only at /model. Required when LLM_BACKEND=vllm."
    },
    "VLLM_SERVED_MODEL": {
      "type": "string",
      "description": "Model id vLLM serves and lists in /v1/models (--served-model-name), e.g. GLM-5.3-Flash-NVFP4. Required when LLM_BACKEND=vllm."
    },
    "VLLM_ARGS": {
      "type": "string",
      "description": "Further vLLM arguments from the model's catalog entry, e.g. --max-model-len 131072 --kv-cache-dtype fp8. Compose splits the string like a shell."
    },
    "VLLM_GPU_UUID": {
      "type": "string",
      "description": "UUID of the one NVIDIA GPU the vLLM engine owns, picked at install (the largest GPU the chosen catalog model fits). Required when LLM_BACKEND=vllm."
    },
    "VLLM_GPU_MEMORY_UTILIZATION": {
      "type": "number",
      "description": "Share of the vLLM GPU's memory that vLLM pre-allocates for weights and KV cache (--gpu-memory-utilization). The installer writes the catalog model's own share when it sets one (0.5 for the RTX PRO 6000 class, so other GPU services fit beside it); without one, 0.9. Lower it to leave room for other GPU services on the same GPU.",
      "minimum": 0.01,
      "maximum": 1,
      "default": 0.9
    },
    "EXTERNAL_LLM_URL": {
      "type": "string",
      "description": "Host-facing base URL of an installer-validated Ollama or LM Studio runtime. Configure with install.sh rather than editing this field alone.",
      "default": ""
    },
    "EXTERNAL_LLM_CONTAINER_URL": {
      "type": "string",
      "description": "Container-facing base URL derived from EXTERNAL_LLM_URL. Loopback hosts are normalized to host.docker.internal.",
      "default": ""
    },
    "EXTERNAL_LLM_PROVIDER": {
      "type": "string",
      "description": "Validated external local model provider.",
      "enum": [
        "",
        "ollama",
        "lmstudio",
        "openai-compatible"
      ],
      "default": ""
    },
    "EXTERNAL_LLM_MODEL": {
      "type": "string",
      "description": "Exact model id exposed by the selected external provider.",
      "default": ""
    },
    "SKIP_MODEL_DOWNLOAD": {
      "type": "string",
      "description": "Installer-owned receipt indicating that a validated external model replaces the ODS-managed GGUF download.",
      "enum": [
        "true",
        "false"
      ],
      "default": "false"
    },
    "MODEL_PROFILE": {
      "type": "string",
      "description": "Tier-aware local model family selection: qwen, gemma4, or auto",
      "enum": [
        "qwen",
        "gemma4",
        "auto"
      ],
      "default": "qwen"
    },
    "LLM_API_BASE_PATH": {
      "type": "string",
      "description": "Base API path for the inference backend",
      "default": "/v1"
    },
    "ODS_TALK_VISION_URL": {
      "type": "string",
      "description": "Optional OpenAI-compatible base URL for ODS Talk image attachments. Accepts either a host root or a base path ending in /v1 or /api/v1.",
      "default": ""
    },
    "ODS_TALK_VISION_KEY": {
      "type": "string",
      "description": "Optional bearer token for the ODS Talk vision backend.",
      "default": ""
    },
    "ODS_TALK_VISION_MODEL": {
      "type": "string",
      "description": "Model id for ODS Talk image attachments. Empty uses the active model; set it with ODS_TALK_VISION_URL for an external vision server.",
      "default": ""
    },
    "AMD_INFERENCE_RUNTIME": {
      "type": "string",
      "description": "Explicit AMD local inference runtime selected by the installer: llama-server. Empty when AMD local inference is not active. lemonade is a retired value accepted for one release.",
      "enum": [
        "",
        "lemonade",
        "llama-server"
      ],
      "default": ""
    },
    "AMD_INFERENCE_BACKEND": {
      "type": "string",
      "description": "AMD acceleration backend of the llama.cpp runtime: vulkan (default) or rocm. On Linux it selects the container image (rocm adds docker-compose.amd-rocm.yml; Instinct cards need it). auto, cpu and npu are retired values accepted for one release.",
      "enum": [
        "",
        "auto",
        "cpu",
        "npu",
        "rocm",
        "vulkan"
      ],
      "default": ""
    },
    "AMD_INFERENCE_LOCATION": {
      "type": "string",
      "description": "Where the selected AMD local inference runtime is running from the dashboard-api container's perspective.",
      "enum": [
        "",
        "container",
        "host"
      ],
      "default": ""
    },
    "AMD_INFERENCE_PORT": {
      "type": "integer",
      "description": "Port of the selected AMD llama-server: 8080 inside the Linux container, or the Windows host port of the Portal's native llama-server.",
      "default": 8080,
      "minimum": 1,
      "maximum": 65535
    },
    "AMD_INFERENCE_SUPPORTED_BACKENDS": {
      "type": "string",
      "description": "Comma-separated AMD accelerator backends declared by the installer for the selected runtime, such as rocm, vulkan, or rocm,vulkan.",
      "default": ""
    },
    "AMD_INFERENCE_RUNTIME_MODE": {
      "type": "string",
      "description": "Installer-declared AMD runtime mode for diagnostics: linux-container, windows-native-llama-server or windows-portal-llama-server. external-lemonade and windows-legacy-lemonade are retired values accepted for one release.",
      "enum": [
        "",
        "linux-container",
        "windows-native-llama-server",
        "windows-portal-llama-server",
        "external-lemonade",
        "windows-legacy-lemonade",
        "windows-llama-server-fallback",
        "unknown"
      ],
      "default": ""
    },
    "AMD_INFERENCE_MANAGED": {
      "type": "string",
      "description": "Whether the selected AMD inference runtime is managed by ODS.",
      "enum": [
        "",
        "true",
        "false"
      ],
      "default": ""
    },
    "TARGET_API_KEY": {
      "type": "string",
      "description": "API key for Privacy Shield upstream target (set to LITELLM_KEY when the upstream is LiteLLM)",
      "secret": true,
      "minLength": 10
    },
    "ANTHROPIC_API_KEY": {
      "type": "string",
      "description": "Anthropic API key (cloud/hybrid modes)",
      "secret": true,
      "minLength": 10
    },
    "OPENAI_API_KEY": {
      "type": "string",
      "description": "OpenAI API key (cloud/hybrid modes)",
      "secret": true,
      "minLength": 10
    },
    "HF_TOKEN": {
      "type": "string",
      "description": "Optional read token for private or gated Hugging Face model repositories",
      "secret": true,
      "minLength": 10
    },
    "ODS_MODEL_DOWNLOAD_ALLOWED_HOSTS": {
      "type": "string",
      "description": "Comma-separated HTTPS hosts permitted for model artifact downloads",
      "default": "huggingface.co,www.huggingface.co,hf.co"
    },
    "TOGETHER_API_KEY": {
      "type": "string",
      "description": "Together AI API key (optional)",
      "secret": true,
      "minLength": 10
    },
    "MINIMAX_API_KEY": {
      "type": "string",
      "description": "MiniMax API key for MiniMax models (cloud/hybrid modes)",
      "secret": true,
      "minLength": 10
    },
    "WEBUI_SECRET": {
      "type": "string",
      "description": "Session signing secret for Open WebUI",
      "secret": true,
      "minLength": 10
    },
    "N8N_USER": {
      "type": "string",
      "description": "n8n initial admin email address",
      "secret": true,
      "minLength": 10
    },
    "N8N_PASS": {
      "type": "string",
      "description": "n8n admin password",
      "secret": true,
      "minLength": 10
    },
    "LITELLM_KEY": {
      "type": "string",
      "description": "LiteLLM API gateway master key",
      "secret": true,
      "minLength": 10
    },
    "LITELLM_LEMONADE_API_KEY": {
      "type": "string",
      "description": "Retired: the Lemonade runtime was removed (AMD now runs llama.cpp); ignored if present. A key you set for your own Lemonade moves to config/litellm/external-upstream.key.",
      "secret": true,
      "clearable": true,
      "minLength": 10,
      "deprecated": true
    },
    "LEMONADE_API_KEY": {
      "type": "string",
      "description": "Retired: the Lemonade runtime was removed (AMD now runs llama.cpp); ignored if present.",
      "secret": true,
      "clearable": true,
      "deprecated": true
    },
    "LEMONADE_EXTERNAL": {
      "type": "string",
      "description": "Retired: the Lemonade runtime was removed (AMD now runs llama.cpp); ignored if present. Your own Lemonade is an external OpenAI-compatible server (EXTERNAL_LLM_URL).",
      "enum": [
        "",
        "true",
        "false"
      ],
      "deprecated": true
    },
    "LEMONADE_HOST_TRANSPORT": {
      "type": "string",
      "enum": ["direct", "model-router"],
      "description": "Retired: the Lemonade runtime was removed (AMD now runs llama.cpp); ignored if present. Replaced by ODS_HOST_LLM_TRANSPORT.",
      "deprecated": true
    },
    "ODS_HOST_LLM_TRANSPORT": {
      "type": "string",
      "enum": ["direct", "model-router"],
      "description": "Network the host agent uses to verify a host-native llama-server: direct, or this installation's model-router container (Windows Portal under WSL)."
    },
    "NATIVE_LLM_BASE_URL": {
      "type": "string",
      "description": "Origin (http://host:port, no path) of an ODS-managed llama-server outside the Docker stack, as seen from the host. The Windows Portal sets it; empty otherwise."
    },
    "NATIVE_LLM_CONTAINER_BASE_URL": {
      "type": "string",
      "description": "The same host-native llama-server origin as seen from containers, usually http://host.docker.internal:<port>."
    },
    "LLAMA_SERVER_API_KEY": {
      "type": "string",
      "description": "API key of the host-native llama-server (Windows Portal), generated by Windows setup. LiteLLM, model-router and the host agent send it as a bearer token; it is never passed on a command line.",
      "secret": true,
      "pattern": "^[0-9A-Fa-f]{32,512}$"
    },
    "ODS_WINDOWS_SYSTEM_DIRECTORY": {
      "type": "string",
      "description": "Local Windows System32 directory supplied by Windows setup; the WSL bridge validates and translates it before using system executables."
    },
    "ODS_WSL_STATE_ROOT": {
      "type": "string",
      "description": "Optional absolute Windows StateRoot selected during setup, preserved for ownership-checked startup retirement. Omitted for the default state location."
    },
    "ODS_WSL_DISK_DRIVE": {
      "type": "string",
      "description": "Windows drive (for example C:) that stores this WSL distribution's virtual disk, recorded by Windows setup. Inside WSL the virtual disk reports its own growth limit, so the host agent also checks this drive's free space before model downloads. Omitted when setup could not find the drive.",
      "pattern": "^[A-Za-z]:$"
    },
    "LEMONADE_BASE_URL": {
      "type": "string",
      "description": "Retired: the Lemonade runtime was removed (AMD now runs llama.cpp); ignored if present. Replaced by NATIVE_LLM_BASE_URL or EXTERNAL_LLM_URL.",
      "deprecated": true
    },
    "LEMONADE_CONTAINER_BASE_URL": {
      "type": "string",
      "description": "Retired: the Lemonade runtime was removed (AMD now runs llama.cpp); ignored if present. Replaced by NATIVE_LLM_CONTAINER_BASE_URL or EXTERNAL_LLM_CONTAINER_URL.",
      "deprecated": true
    },
    "LEMONADE_API_BASE_PATH": {
      "type": "string",
      "description": "Retired: the Lemonade runtime was removed (AMD now runs llama.cpp); ignored if present. llama-server serves /v1.",
      "deprecated": true
    },
    "LEMONADE_MODEL": {
      "type": "string",
      "description": "Retired: the Lemonade runtime was removed (AMD now runs llama.cpp); ignored if present. The served model id is GGUF_FILE (or EXTERNAL_LLM_MODEL for an external server).",
      "deprecated": true
    },
    "OPENCLAW_TOKEN": {
      "type": "string",
      "description": "Retired: the legacy OpenClaw extension was removed; ignored if present.",
      "secret": true,
      "clearable": true,
      "deprecated": true
    },
    "ENABLE_PIXEL": {
      "type": "string",
      "description": "Pixel selection policy: auto prefers Pixel on a qualified host; true requires Pixel; false selects the fallback.",
      "enum": ["auto", "true", "false"],
      "default": "auto"
    },
    "PIXEL_AGENT_MODE": {
      "type": "string",
      "description": "Resolved default agent selected by the installer.",
      "enum": ["pixel", "hermes"]
    },
    "PIXEL_SOURCE_URL": {
      "type": "string",
      "description": "Bundled Pixel source (default); an authorized Git URL or owner-controlled absolute checkout is an explicit developer override."
    },
    "PIXEL_SOURCE_REF": {
      "type": "string",
      "description": "Immutable full lowercase Pixel commit SHA.",
      "pattern": "^[0-9a-f]{40}$"
    },
    "PIXEL_SOURCE_DIR": {
      "type": "string",
      "description": "Secure owner-controlled parent directory for a local Pixel source checkout."
    },
    "PIXEL_GATEWAY_PORT": {
      "type": "integer",
      "description": "Loopback-only Pixel gateway port selected at first installation and retained for reinstall reconciliation.",
      "minimum": 1,
      "maximum": 65535,
      "default": 18789
    },
    "PIXEL_MODEL_RELAY_PORT": {
      "type": "integer",
      "description": "Pixel-only authenticated host-loopback model relay; LiteLLM and other consumers retain their existing route.",
      "minimum": 1,
      "maximum": 65535,
      "default": 4006
    },
    "PIXEL_MODEL_RELAY_KEY": {
      "type": "string",
      "description": "Installer-generated bearer token for Pixel's dedicated local model relay.",
      "secret": true,
      "minLength": 64,
      "maxLength": 64,
      "pattern": "^[0-9a-f]{64}$"
    },
    "PIXEL_INFERENCE_PORT": {
      "type": "integer",
      "description": "Loopback-only port for optional, disabled-by-default Pixel inference sharing.",
      "minimum": 1024,
      "maximum": 65535,
      "default": 4005
    },
    "PIXEL_WEB_SEARCH_PROVIDER": {
      "type": "string",
      "description": "Explicit native search choice. When absent, preserve existing Pixel onboarding; fresh installations use OpenClaw parallel-free without another ODS application. SearXNG remains an optional local provider.",
      "enum": ["parallel-free", "searxng"]
    },
    "PIXEL_RESPONSE_LANGUAGE": {
      "type": "string",
      "description": "en keeps Pixel's replies, clarification questions and the content it creates in English, whatever language the owner writes. When absent, Pixel matches the owner's message and falls back to English.",
      "enum": ["en"]
    },
    "PIXEL_PREVIEW_PORT": {
      "type": "integer",
      "description": "Dedicated loopback port for host-verified Pixel workspace previews.",
      "minimum": 1,
      "maximum": 65535,
      "default": 9437
    },
    "PIXEL_OPENWEBUI_KEY": {
      "type": "string",
      "description": "Installer-generated scoped bearer token for Open WebUI and Dashboard access to the internal Pixel edge only.",
      "secret": true,
      "minLength": 64,
      "maxLength": 64,
      "pattern": "^[0-9a-f]{64}$"
    },
    "PIXEL_INGRESS_RUNTIME_DIR": {
      "type": "string",
      "description": "Fixed host runtime directory containing the Pixel ingress socket and sanitized status projection.",
      "enum": ["/run/ods-pixel", "/mnt/wsl/ods-portal-runtime/ingress"],
      "default": "/run/ods-pixel"
    },
    "PIXEL_PREVIEW_RUNTIME_DIR": {
      "type": "string",
      "description": "Fixed host runtime directory containing the authenticated Pixel preview relay socket.",
      "enum": ["/run/ods-pixel-preview", "/mnt/wsl/ods-portal-runtime/preview"],
      "default": "/run/ods-pixel-preview"
    },
    "PIXEL_RUNTIME_BIND_PROPAGATION": {
      "type": "string",
      "description": "Private bind on native Linux; shared WSL bridge propagation with Docker Desktop.",
      "enum": ["rprivate", "rshared"],
      "default": "rprivate"
    },
    "PIXEL_INGRESS_GID": {
      "type": "integer",
      "description": "Numeric GID of the host ods-pixel group granted access to the private ingress socket.",
      "minimum": 1
    },
    "OPENCLAW_DANGEROUSLY_DISABLE_DEVICE_AUTH": {
      "type": "string",
      "description": "Retired: the legacy OpenClaw extension was removed; ignored if present.",
      "deprecated": true
    },
    "BIND_ADDRESS": {
      "type": "string",
      "description": "IP address for Docker port bindings. 127.0.0.1 (default) for localhost-only access. 0.0.0.0 for LAN access on headless servers. See SECURITY.md.",
      "enum": ["127.0.0.1", "0.0.0.0"],
      "default": "127.0.0.1"
    },
    "HOST_LAN_IP": {
      "type": "string",
      "description": "Retired: the legacy OpenClaw extension was removed; ignored if present. Installers wrote it only for that extension.",
      "deprecated": true
    },
    "GGUF_FILE": {
      "type": "string",
      "description": "Model GGUF filename in data/models/"
    },
    "CTX_SIZE": {
      "type": "integer",
      "description": "Context window size in tokens",
      "default": 16384
    },
    "MAX_CONTEXT": {
      "type": "integer",
      "description": "Context window (installer variable, maps to CTX_SIZE)"
    },
    "GPU_BACKEND": {
      "type": "string",
      "description": "GPU backend the installer detected: nvidia, amd, apple, cpu, jetson, or sycl (Intel Arc via oneAPI; detection may also record intel)",
      "default": "nvidia"
    },
    "GPU_COMPUTE_CAP": {
      "type": "string",
      "description": "Compute capability of the NVIDIA GPU the installer detected (nvidia-smi compute_cap), for example 12.1 on a DGX Spark GB10 or RTX Spark N1X. The installer and the host agent pick the llama.cpp image that config/backends/nvidia.json pins for it.",
      "pattern": "^[0-9]+\\.[0-9]+$"
    },
    "N_GPU_LAYERS": {
      "type": "string",
      "description": "llama.cpp GPU layer offload policy: auto, all, or a non-negative layer count. CPU and Intel/Arc overlays may set an explicit numeric value.",
      "pattern": "^(?:auto|all|[0-9]+)$",
      "default": "auto"
    },
    "LLAMA_BATCH_SIZE": {
      "type": "integer",
      "description": "llama.cpp prompt processing batch size. Higher values can improve prefill throughput but use more memory.",
      "minimum": 1,
      "default": 2048
    },
    "LLAMA_THREADS": {
      "type": "integer",
      "description": "CPU threads for llama.cpp non-GPU work.",
      "minimum": 1,
      "default": 4
    },
    "HOST_RAM_GB": {
      "type": "integer",
      "description": "Unified system RAM in GB. macOS Apple Silicon only; the macOS env-generator writes it from sysctl hw.memsize and it is passed to llama.cpp for the Metal backend so it can size the unified-memory pool. Not written on Linux or Windows .env files. Not sensitive.",
      "minimum": 1,
      "maximum": 1024
    },
    "LLM_MODEL": {
      "type": "string",
      "description": "Model name used by the dashboard and model-aware services"
    },
    "GGUF_URL": {
      "type": "string",
      "description": "Integrity-pinned download URL for the active managed GGUF."
    },
    "GGUF_SHA256": {
      "type": "string",
      "description": "Optional SHA-256 integrity pin for the active managed GGUF.",
      "pattern": "^(?:|[0-9a-f]{64})$"
    },
    "ODS_ACTIVE_MODEL_STORE": {
      "type": "string",
      "description": "Registered model store selected for native inference; default uses data/models",
      "pattern": "^[a-z][a-z0-9-]{0,47}$"
    },
    "MODEL_SELECTION_SOURCE": {
      "type": "string",
      "description": "Owner of the active model selection. Installer recommendations remain separate from Dashboard or operator choices.",
      "enum": ["installer", "dashboard", "operator", "preserved-local"]
    },
    "MODEL_RECOMMENDED_MODEL": {
      "type": "string",
      "description": "Installer-selected full local model. This remains the hardware recommendation even while a bootstrap model is temporarily loaded."
    },
    "MODEL_RECOMMENDED_GGUF": {
      "type": "string",
      "description": "GGUF filename for the installer-selected full local model."
    },
    "MODEL_RECOMMENDED_CONTEXT": {
      "type": "integer",
      "description": "Context window selected by the installer for the recommended full local model."
    },
    "MODEL_RECOMMENDATION_SOURCE": {
      "type": "string",
      "description": "Source of the installer model recommendation, for dashboard display and diagnostics."
    },
    "MODEL_RECOMMENDATION_POLICY": {
      "type": "string",
      "description": "Versioned policy used to select the recommended full local model before any model is downloaded."
    },
    "MODEL_RECOMMENDATION_CONFIDENCE": {
      "type": "string",
      "description": "Confidence level for the installer model recommendation.",
      "enum": ["low", "medium", "high"]
    },
    "MODEL_RECOMMENDATION_REASON": {
      "type": "string",
      "description": "Human-readable explanation for why the installer selected the recommended model."
    },
    "MODEL_RECOMMENDED_ALTERNATIVES": {
      "type": "string",
      "description": "Semicolon-delimited top catalog alternatives from the pre-download selector, encoded as id:context:estimated_required_gb."
    },
    "MODEL_PERFORMANCE_SOURCE": {
      "type": "string",
      "description": "Initial performance source for the recommended model before local benchmarking.",
      "enum": ["benchmark_required", "measured_local", "published_exact", "predicted_calibrated", "incompatible"]
    },
    "MODEL_PERFORMANCE_LABEL": {
      "type": "string",
      "description": "Initial dashboard performance label for the recommended model before local benchmarking."
    },
    "MODEL_RUNTIME_PROFILE": {
      "type": "string",
      "description": "Optional catalog runtime profile applied to the selected model."
    },
    "MODEL_RUNTIME_PROFILE_LABEL": {
      "type": "string",
      "description": "User-facing label for the applied model runtime profile."
    },
    "MODEL_RUNTIME_PROFILE_SOURCE": {
      "type": "string",
      "description": "Reference URL for the applied model runtime profile."
    },
    "MODEL_CHAT_TEMPLATE_OVERRIDE": {
      "type": "string",
      "description": "Id of the fixed chat template (config/chat-templates/index.json) the active model runs with instead of its own broken one. Model activation sets it only on an exact template match and removes it for every other model; do not set it by hand.",
      "pattern": "^[a-z0-9](?:[a-z0-9.-]{0,62}[a-z0-9])?$"
    },
    "LLAMA_SERVER_IMAGE": {
      "type": "string",
      "description": "Optional llama.cpp container image override for model families that require newer runtime support"
    },
    "LLAMA_SERVER_IMAGE_FALLBACK": {
      "type": "string",
      "description": "Optional explicit fallback image if a custom llama.cpp image tag disappears or fails to pull."
    },
    "LEMONADE_SERVER_IMAGE": {
      "type": "string",
      "description": "Retired: the Lemonade runtime was removed (AMD now runs llama.cpp); ignored if present. The AMD overlays pin the llama.cpp images in config/backends/amd.json.",
      "deprecated": true
    },
    "WHISPER_IMAGE": {
      "type": "string",
      "description": "Optional speaches/whisper image override. Installers may set this to the CPU image when the NVIDIA driver is too old for the CUDA tag."
    },
    "WHISPER_ACCELERATION": {
      "type": "string",
      "description": "Whisper runtime acceleration selected independently from the primary LLM backend. NVIDIA installs fall back to cpu when the installed driver cannot run the CUDA image, and on arm64, where that image has no CUDA.",
      "enum": ["cpu", "cuda"]
    },
    "LLAMA_CPU_LIMIT": {
      "type": "number",
      "description": "Auto-capped Docker CPU limit for llama-server",
      "minimum": 0.01
    },
    "LLAMA_CPU_RESERVATION": {
      "type": "number",
      "description": "Auto-capped Docker CPU reservation for llama-server",
      "minimum": 0.01
    },
    "TTS_CPU_LIMIT": {
      "type": "number",
      "description": "Auto-capped Docker CPU limit for Kokoro TTS",
      "minimum": 0.01
    },
    "TTS_CPU_RESERVATION": {
      "type": "number",
      "description": "Auto-capped Docker CPU reservation for Kokoro TTS",
      "minimum": 0.01
    },
    "TTS_WORKERS": {
      "type": "integer",
      "description": "Kokoro TTS worker processes (one by default on every platform)",
      "minimum": 1
    },
    "TTS_THREADS": {
      "type": "integer",
      "description": "CPU threads per Kokoro worker; installer caps explicit values to the service CPU quota and worker count",
      "minimum": 1
    },
    "WHISPER_CPU_LIMIT": {
      "type": "number",
      "description": "Auto-capped Docker CPU limit for Whisper STT",
      "minimum": 0.01
    },
    "WHISPER_CPU_RESERVATION": {
      "type": "number",
      "description": "Auto-capped Docker CPU reservation for Whisper STT",
      "minimum": 0.01
    },
    "HERMES_CPU_LIMIT": {
      "type": "number",
      "description": "Auto-capped Docker CPU limit for Hermes Agent",
      "minimum": 0.01
    },
    "HERMES_CPU_RESERVATION": {
      "type": "number",
      "description": "Auto-capped Docker CPU reservation for Hermes Agent",
      "minimum": 0.01
    },
    "COMFYUI_CPU_LIMIT": {
      "type": "number",
      "description": "Auto-capped Docker CPU limit for ComfyUI",
      "minimum": 0.01
    },
    "COMFYUI_CPU_RESERVATION": {
      "type": "number",
      "description": "Auto-capped Docker CPU reservation for ComfyUI",
      "minimum": 0.01
    },
    "LLAMA_START_PERIOD": {
      "type": "string",
      "description": "Healthcheck grace window for llama-server cold model load (Docker duration, e.g. 240s, 5m). Bump for 70B-class GGUFs on slow NVMe."
    },
    "TIER": {
      "type": "string",
      "description": "Hardware tier (1, 2, 3, 4, CLOUD, SH_COMPACT, SH_LARGE, NV_ULTRA)"
    },
    "OLLAMA_PORT": {
      "type": "integer",
      "description": "llama-server external port",
      "default": 11434
    },
    "WEBUI_PORT": {
      "type": "integer",
      "description": "Open WebUI external port",
      "default": 3000
    },
    "SEARXNG_PORT": {
      "type": "integer",
      "description": "SearXNG external port",
      "default": 8888
    },
    "SEARXNG_SECRET": {
      "type": "string",
      "description": "SearXNG session signing secret",
      "secret": true,
      "minLength": 10
    },
    "BRAVE_SEARCH_PORT": {
      "type": "integer",
      "description": "Brave Search proxy external port",
      "default": 8585
    },
    "BRAVE_SEARCH_API_KEY": {
      "type": "string",
      "description": "Brave Search API subscription token (obtain at api.search.brave.com)",
      "secret": true
    },
    "PERPLEXICA_PORT": {
      "type": "integer",
      "description": "Perplexica external port",
      "default": 3004
    },
    "PERPLEXICA_SCRAPE_URL_MAX_CHARS": {
      "type": "integer",
      "description": "Maximum characters kept per URL from Perplexica scrape_url before synthesis",
      "default": 30000,
      "minimum": 1000
    },
    "WHISPER_PORT": {
      "type": "integer",
      "description": "Whisper STT external port",
      "default": 9000
    },
    "TTS_PORT": {
      "type": "integer",
      "description": "Kokoro TTS external port",
      "default": 8880
    },
    "N8N_PORT": {
      "type": "integer",
      "description": "n8n external port",
      "default": 5678
    },
    "QDRANT_PORT": {
      "type": "integer",
      "description": "Qdrant vector DB external port",
      "default": 6333
    },
    "QDRANT_GRPC_PORT": {
      "type": "integer",
      "description": "Qdrant gRPC external port",
      "default": 6334
    },
    "QDRANT_API_KEY": {
      "type": "string",
      "description": "Qdrant vector DB API key",
      "secret": true,
      "minLength": 10
    },
    "EMBEDDINGS_PORT": {
      "type": "integer",
      "description": "Text embeddings external port",
      "default": 8090
    },
    "LITELLM_PORT": {
      "type": "integer",
      "description": "LiteLLM gateway external port",
      "default": 4000
    },
    "OPENCLAW_PORT": {
      "type": "integer",
      "description": "Retired: the legacy OpenClaw extension was removed; ignored if present.",
      "deprecated": true
    },
    "SHIELD_PORT": {
      "type": "integer",
      "description": "Privacy Shield external port",
      "default": 8085
    },
    "DASHBOARD_API_PORT": {
      "type": "integer",
      "description": "Dashboard API external port",
      "default": 3002
    },
    "DASHBOARD_PORT": {
      "type": "integer",
      "description": "Dashboard UI host-loopback port; browsers on this machine do not sign in",
      "default": 3001
    },
    "DASHBOARD_REMOTE_PORT": {
      "type": "integer",
      "description": "Dashboard UI network port; browser sign-in is required when BIND_ADDRESS exposes it",
      "default": 3011
    },
    "COMFYUI_PORT": {
      "type": "integer",
      "description": "ComfyUI external port",
      "default": 8188
    },
    "TOKEN_SPY_PORT": {
      "type": "integer",
      "description": "Token Spy external port",
      "default": 3005
    },
    "TOKEN_SPY_URL": {
      "type": "string",
      "description": "Internal URL for Token Spy service (overridable for non-default deployments)",
      "default": "http://token-spy:8080"
    },
    "TOKEN_SPY_API_KEY": {
      "type": "string",
      "description": "API key shared by Token Spy and dashboard-api; generated by the installer, with existing Token Spy key files preserved on upgrade",
      "secret": true,
      "minLength": 10
    },
    "LLAMA_SERVER_PORT": {
      "type": "integer",
      "description": "Deprecated: use OLLAMA_PORT instead",
      "default": 8080
    },
    "DASHBOARD_API_KEY": {
      "type": "string",
      "description": "Dashboard API authentication key",
      "secret": true,
      "minLength": 10
    },
    "ODS_AGENT_KEY": {
      "type": "string",
      "description": "API key for the ODS Host Agent (falls back to DASHBOARD_API_KEY if unset)",
      "secret": true,
      "minLength": 10
    },
    "APE_API_KEY": {
      "type": "string",
      "description": "API key for the APE (AI Proxy Engine) extension",
      "secret": true,
      "minLength": 10
    },
    "SHIELD_API_KEY": {
      "type": "string",
      "description": "API key for the Privacy Shield extension",
      "secret": true,
      "minLength": 10
    },
    "OPENCODE_SERVER_PASSWORD": {
      "type": "string",
      "description": "Optional password for a manually network-exposed OpenCode server. ODS-managed OpenCode is loopback-only and opens without a login.",
      "secret": true,
      "minLength": 10
    },
    "OPENCODE_PORT": {
      "type": "integer",
      "description": "OpenCode web UI external port",
      "default": 3003
    },
    "WEBUI_AUTH": {
      "type": "boolean",
      "description": "Enable Open WebUI authentication. ODS installers default to false on loopback and true for network-bound installs.",
      "default": true
    },
    "WEBUI_NAME": {
      "type": "string",
      "description": "Open WebUI display + PWA install name. Surfaces as page title, app header, and the label next to the icon when the user adds ODS to their phone home screen.",
      "default": "ODS"
    },
    "WEBUI_URL": {
      "type": "string",
      "description": "Optional Open WebUI public URL used for share links, OAuth callbacks, and PWA install metadata. Leave empty for traditional localhost usage. Set to http://chat.<ODS_DEVICE_NAME>.local after enabling ods-proxy + mDNS, or to a Tailscale Funnel / Cloudflare Tunnel / custom domain URL.",
      "default": ""
    },
    "ODS_DEVICE_NAME": {
      "type": "string",
      "description": "Device name used by mDNS announcement and as the hostname segment for proxy/headless URLs. Letters / digits / hyphens only.",
      "default": "ods",
      "pattern": "^[a-zA-Z0-9][a-zA-Z0-9-]{0,30}[a-zA-Z0-9]$|^[a-zA-Z0-9]$"
    },
    "WHISPER_MODEL": {
      "type": "string",
      "description": "Whisper STT model size",
      "default": "base"
    },
    "WHISPER_URL": {
      "type": "string",
      "description": "Internal Whisper STT URL used by dashboard-api and ODS Talk. Leave empty for the bundled whisper service."
    },
    "AUDIO_STT_ENGINE": {
      "type": "string",
      "description": "Open WebUI speech-to-text engine.",
      "default": "openai"
    },
    "AUDIO_STT_OPENAI_API_BASE_URL": {
      "type": "string",
      "description": "OpenAI-compatible speech-to-text base URL used by Open WebUI.",
      "default": "http://whisper:8000/v1"
    },
    "AUDIO_STT_OPENAI_API_KEY": {
      "type": "string",
      "description": "Optional API key for the Open WebUI speech-to-text backend.",
      "secret": true,
      "minLength": 10
    },
    "AUDIO_STT_MODEL": {
      "type": "string",
      "description": "Whisper STT model (HuggingFace repo ID). Auto-set by installer based on GPU backend: NVIDIA picks large-v3-turbo (faster, ~1.5GB), others pick base (~130MB). Edit in .env to override, then run `ods restart` (or reinstall).",
      "default": "Systran/faster-whisper-base"
    },
    "TTS_URL": {
      "type": "string",
      "description": "Internal Kokoro TTS URL used by dashboard-api and ODS Talk. Leave empty for the bundled tts service."
    },
    "AUDIO_TTS_ENGINE": {
      "type": "string",
      "description": "Open WebUI text-to-speech engine.",
      "default": "openai"
    },
    "AUDIO_TTS_OPENAI_API_BASE_URL": {
      "type": "string",
      "description": "OpenAI-compatible text-to-speech base URL used by Open WebUI.",
      "default": "http://tts:8880/v1"
    },
    "AUDIO_TTS_OPENAI_API_KEY": {
      "type": "string",
      "description": "Optional API key for the Open WebUI text-to-speech backend.",
      "secret": true,
      "minLength": 10
    },
    "AUDIO_TTS_MODEL": {
      "type": "string",
      "description": "Open WebUI/ODS Talk text-to-speech model id.",
      "default": "kokoro"
    },
    "AUDIO_TTS_VOICE": {
      "type": "string",
      "description": "Open WebUI/ODS Talk Kokoro voice id.",
      "default": "af_heart"
    },
    "TIMEZONE": {
      "type": "string",
      "description": "System timezone",
      "default": "UTC"
    },
    "N8N_AUTH": {
      "type": "boolean",
      "description": "Deprecated: n8n v2.x has built-in user management. This variable is ignored.",
      "default": true
    },
    "N8N_RUN_USER": {
      "type": "string",
      "description": "Override the n8n container user. Native macOS uses node; otherwise Compose defaults to ODS_UID:ODS_GID."
    },
    "N8N_HOST": {
      "type": "string",
      "description": "n8n hostname",
      "default": "localhost"
    },
    "N8N_WEBHOOK_URL": {
      "type": "string",
      "description": "n8n webhook URL for external access"
    },
    "N8N_SECURE_COOKIE": {
      "type": "string",
      "enum": ["auto", "true", "false"],
      "description": "n8n session-cookie policy. auto disables Secure only for loopback HTTP and enables it for HTTPS or non-loopback binds.",
      "default": "auto"
    },
    "N8N_PROXY_HOPS": {
      "type": "integer",
      "minimum": 0,
      "description": "Number of trusted reverse proxies in front of n8n.",
      "default": 0
    },
    "N8N_API_KEY": {
      "type": "string",
      "description": "n8n public API key (create in n8n under Settings > n8n API). Dashboard API sends it to list, install and remove catalog workflows.",
      "secret": true
    },
    "EMBEDDING_MODEL": {
      "type": "string",
      "description": "Canonical Hugging Face model repository loaded by bundled TEI and used as Open WebUI's RAG embedding model unless RAG_EMBEDDING_MODEL is set; Open WebUI reads it at every start. GGUF/Q4 model files are not compatible with this runtime.",
      "default": "BAAI/bge-base-en-v1.5"
    },
    "RAG_EMBEDDING_MODEL": {
      "type": "string",
      "description": "Optional Open WebUI embedding-model override, read at every Open WebUI start. Leave empty to use EMBEDDING_MODEL. Use a different model only with a matching external RAG_OPENAI_API_BASE_URL."
    },
    "RAG_OPENAI_API_BASE_URL": {
      "type": "string",
      "description": "OpenAI-compatible embeddings endpoint used by Open WebUI. Leave empty for the bundled TEI service."
    },
    "RAG_OPENAI_API_KEY": {
      "type": "string",
      "description": "Optional API key for an authenticated external OpenAI-compatible RAG embeddings endpoint.",
      "secret": true,
      "clearable": true
    },
    "EMBEDDINGS_MEMORY_LIMIT": {
      "type": "string",
      "description": "Docker memory limit for the bundled TEI embeddings service, for example 4G or 6G.",
      "default": "4G",
      "pattern": "^[1-9][0-9]*([bBkKmMgG]|[kKmMgG][bB])?$"
    },
    "EMBEDDING_URL": {
      "type": "string",
      "description": "Embedding service URL used by dashboard-api functional diagnostics. Leave empty for the bundled embeddings service."
    },
    "VIDEO_GID": {
      "type": "integer",
      "description": "GID of the 'video' group on the host (used in container group_add for AMD GPU access)",
      "default": 44
    },
    "RENDER_GID": {
      "type": "integer",
      "description": "GID of the 'render' group on the host (used in container group_add for AMD GPU access)",
      "default": 992
    },
    "ONEAPI_DEVICE_SELECTOR": {
      "type": "string",
      "description": "oneAPI device filter passed to the Intel (SYCL) llama-server containers. Phase 06 writes 'level_zero:gpu' when GPU_BACKEND=sycl and keeps an existing value on reruns. On hosts with more than one Intel GPU, set level_zero:0: the oneAPI runtime in the llama.cpp b9014 image can crash when it sees several Level Zero GPUs (ggml-org/llama.cpp#21747). See docs/INTEL-ARC-GUIDE.md.",
      "default": "level_zero:gpu"
    },
    "SYCL_CACHE_PERSISTENT": {
      "type": "integer",
      "description": "Deprecated and ignored. Earlier installers wrote 1 for GPU_BACKEND=sycl; ODS no longer passes it to llama-server, because the persistent SYCL kernel cache crashes llama-server with the oneAPI 2025.3 runtime (ggml-org/llama.cpp#21474, #22095). Retained so existing .env files still validate."
    },
    "ZES_ENABLE_SYSMAN": {
      "type": "integer",
      "description": "Enable Level Zero Sysman so the Intel Arc runtime can report GPU memory (1 = on). Phase 06 writes it for GPU_BACKEND=sycl.",
      "default": 1
    },
    "HSA_OVERRIDE_GFX_VERSION": {
      "type": "string",
      "description": "ROCm HSA gfx-target override (HSA-version format, e.g. '11.0.0'). Used only by the ROCm image (AMD_INFERENCE_BACKEND=rocm); Vulkan never reads it. Phase 06 sets it only for an RDNA2 or RDNA3 GPU the ROCm image was not built for, mapping it to its built sibling. Leave it unset for built targets (gfx908, gfx90a, gfx942, gfx1030, gfx1100-gfx1102, gfx1150, gfx1151, gfx1200, gfx1201): a wrong value fails model load or can hang the GPU."
    },
    "ROCBLAS_USE_HIPBLASLT": {
      "type": "integer",
      "description": "rocBLAS uses hipBLASLt kernels when 1 (ROCm image only; docker-compose.amd-rocm.yml defaults to 0)."
    },
    "HSA_XNACK": {
      "type": "integer",
      "description": "Retired: the Lemonade runtime was removed (AMD now runs llama.cpp); ignored if present.",
      "deprecated": true
    },
    "AMDGPU_TARGET": {
      "type": "string",
      "description": "Retired: the Lemonade runtime was removed (AMD now runs llama.cpp); ignored if present. ODS no longer builds llama.cpp for AMD.",
      "deprecated": true
    },
    "LLAMA_CPP_REF": {
      "type": "string",
      "description": "Retired: the Lemonade runtime was removed (AMD now runs llama.cpp); ignored if present. ODS no longer builds llama.cpp for AMD; the image is pinned.",
      "deprecated": true
    },
    "ODS_UID": {
      "type": "integer",
      "description": "Host user ID persisted for Docker Compose service ownership without colliding with Bash's readonly UID variable",
      "default": 1000
    },
    "ODS_GID": {
      "type": "integer",
      "description": "Host group ID persisted for Docker Compose service ownership",
      "default": 1000
    },
    "UID": {
      "type": "integer",
      "description": "Deprecated container user ID key retained for existing .env files; installers migrate it to ODS_UID"
    },
    "GID": {
      "type": "integer",
      "description": "Deprecated container group ID key retained for existing .env files; installers migrate it to ODS_GID"
    },
    "PII_CACHE_ENABLED": {
      "type": "boolean",
      "description": "Privacy Shield PII cache",
      "default": true
    },
    "PII_CACHE_SIZE": {
      "type": "integer",
      "description": "Privacy Shield PII cache size",
      "default": 1000
    },
    "PII_CACHE_TTL": {
      "type": "integer",
      "description": "Privacy Shield PII cache TTL (seconds)",
      "default": 300
    },
    "LOG_LEVEL": {
      "type": "string",
      "description": "Logging level",
      "default": "info"
    },
    "BOOTSTRAP_MODEL": {
      "type": "string",
      "description": "Retired: the legacy OpenClaw extension was removed; ignored if present.",
      "deprecated": true
    },
    "KOKORO_URL": {
      "type": "string",
      "description": "Kokoro TTS internal URL",
      "default": "http://tts:8880"
    },
    "N8N_URL": {
      "type": "string",
      "description": "n8n internal URL",
      "default": "http://n8n:5678"
    },
    "LLAMA_SERVER_MEMORY_LIMIT": {
      "type": "string",
      "description": "Docker memory limit for llama-server. NVIDIA installs derive a host-safe value when this is unset; CPU installs write it only when the selected model's runtime profile sizes it (otherwise the CPU compose default, 6G, applies). An existing value is preserved. Remove the generated key before rerunning the installer to recalculate after Docker memory changes.",
      "default": "64G"
    },
    "LIVEKIT_API_KEY": {
      "type": "string",
      "description": "LiveKit API key",
      "secret": true
    },
    "LIVEKIT_API_SECRET": {
      "type": "string",
      "description": "LiveKit API secret",
      "secret": true
    },
    "ENABLE_WEB_SEARCH": {
      "type": "boolean",
      "description": "Enable web search in Open WebUI"
    },
    "WEB_SEARCH_ENGINE": {
      "type": "string",
      "description": "Web search engine backend"
    },
    "TTS_VOICE": {
      "type": "string",
      "description": "Text-to-speech voice"
    },
    "ANYTHINGLLM_PORT": {
      "type": "integer",
      "description": "AnythingLLM external port",
      "minimum": 1,
      "maximum": 65535,
      "default": 7800
    },
    "ANYTHINGLLM_JWT_SECRET": {
      "type": "string",
      "description": "JWT secret for session tokens (auto-generated by setup.sh)",
      "secret": true
    },
    "ANYTHINGLLM_AUTH_TOKEN": {
      "type": "string",
      "description": "API authentication token (auto-generated by setup.sh)",
      "secret": true
    },
    "AUDIOCRAFT_PORT": {
      "type": "integer",
      "description": "AudioCraft external port",
      "minimum": 1,
      "maximum": 65535,
      "default": 7863
    },
    "BARK_PORT": {
      "type": "integer",
      "description": "Bark TTS external port",
      "minimum": 1,
      "maximum": 65535,
      "default": 9200
    },
    "BASEROW_PORT": {
      "type": "integer",
      "description": "Baserow external port",
      "minimum": 1,
      "maximum": 65535,
      "default": 3007
    },
    "CHROMADB_PORT": {
      "type": "integer",
      "description": "ChromaDB external port",
      "minimum": 1,
      "maximum": 65535,
      "default": 8000
    },
    "CONTINUE_PORT": {
      "type": "integer",
      "description": "Continue (AI Coding Assistant) external port",
      "minimum": 1,
      "maximum": 65535,
      "default": 8890
    },
    "CREWAI_PORT": {
      "type": "integer",
      "description": "CrewAI external port",
      "minimum": 1,
      "maximum": 65535,
      "default": 8501
    },
    "DIFY_PORT": {
      "type": "integer",
      "description": "Dify external port",
      "minimum": 1,
      "maximum": 65535,
      "default": 8002
    },
    "FLOWISE_PORT": {
      "type": "integer",
      "description": "Flowise external port",
      "minimum": 1,
      "maximum": 65535,
      "default": 7801
    },
    "FLOWISE_USERNAME": {
      "type": "string",
      "description": "Admin username for Flowise UI (default: admin)"
    },
    "FLOWISE_PASSWORD": {
      "type": "string",
      "description": "Admin password for Flowise UI (auto-generated by setup.sh)",
      "secret": true
    },
    "FOOOCUS_PORT": {
      "type": "integer",
      "description": "Fooocus external port",
      "minimum": 1,
      "maximum": 65535,
      "default": 7865
    },
    "FORGE_PORT": {
      "type": "integer",
      "description": "Forge / A1111 external port",
      "minimum": 1,
      "maximum": 65535,
      "default": 7861
    },
    "FRIGATE_PORT": {
      "type": "integer",
      "description": "Frigate external port",
      "minimum": 1,
      "maximum": 65535,
      "default": 8971
    },
    "FRIGATE_RTSP_PASSWORD": {
      "type": "string",
      "description": "RTSP password for camera streams",
      "secret": true
    },
    "GAIA_PORT": {
      "type": "integer",
      "description": "Retired: the AMD GAIA library recipe was removed; only a GAIA copy installed before then still reads it.",
      "deprecated": true
    },
    "GITEA_PORT": {
      "type": "integer",
      "description": "Gitea (Git Hosting) external port",
      "minimum": 1,
      "maximum": 65535,
      "default": 7830
    },
    "IMMICH_PORT": {
      "type": "integer",
      "description": "Immich external port",
      "minimum": 1,
      "maximum": 65535,
      "default": 2283
    },
    "IMMICH_DB_PASSWORD": {
      "type": "string",
      "description": "PostgreSQL password",
      "secret": true
    },
    "INVOKEAI_PORT": {
      "type": "integer",
      "description": "InvokeAI external port",
      "minimum": 1,
      "maximum": 65535,
      "default": 9090
    },
    "JAN_PORT": {
      "type": "integer",
      "description": "Jan external port",
      "minimum": 1,
      "maximum": 65535,
      "default": 1337
    },
    "JUPYTER_PORT": {
      "type": "integer",
      "description": "Jupyter external port",
      "minimum": 1,
      "maximum": 65535,
      "default": 8889
    },
    "JUPYTER_TOKEN": {
      "type": "string",
      "description": "Access token for Jupyter",
      "secret": true
    },
    "LABEL_STUDIO_PORT": {
      "type": "integer",
      "description": "Label Studio external port",
      "minimum": 1,
      "maximum": 65535,
      "default": 8086
    },
    "LANGFLOW_PORT": {
      "type": "integer",
      "description": "Langflow external port",
      "minimum": 1,
      "maximum": 65535,
      "default": 7802
    },
    "LANGFLOW_SUPERUSER": {
      "type": "string",
      "description": "Langflow superuser username",
      "default": "admin"
    },
    "LANGFLOW_SUPERUSER_PASSWORD": {
      "type": "string",
      "description": "Password for the Langflow superuser (auto-generated on install)",
      "secret": true
    },
    "LANGFLOW_SECRET_KEY": {
      "type": "string",
      "description": "Stable key Langflow uses to encrypt stored credentials and sign sessions (auto-generated on install)",
      "secret": true
    },
    "LIBRECHAT_PORT": {
      "type": "integer",
      "description": "LibreChat external port",
      "minimum": 1,
      "maximum": 65535,
      "default": 3080
    },
    "JWT_SECRET": {
      "type": "string",
      "description": "JWT signing secret for user sessions (auto-generated by setup.sh)",
      "secret": true
    },
    "JWT_REFRESH_SECRET": {
      "type": "string",
      "description": "JWT refresh token secret (auto-generated by setup.sh)",
      "secret": true
    },
    "LIBRECHAT_MONGO_PASSWORD": {
      "type": "string",
      "description": "MongoDB root password for librechat-mongodb (auto-generated by setup.sh)",
      "secret": true
    },
    "LIBRECHAT_MEILI_KEY": {
      "type": "string",
      "description": "Meilisearch master key for librechat-meilisearch (auto-generated by setup.sh)",
      "secret": true
    },
    "LOCALAI_EXTERNAL_PORT": {
      "type": "integer",
      "description": "LocalAI (OpenAI-compatible API) external port",
      "minimum": 1,
      "maximum": 65535,
      "default": 7803
    },
    "MILVUS_PORT": {
      "type": "integer",
      "description": "Milvus (Vector Database) external port",
      "minimum": 1,
      "maximum": 65535,
      "default": 19530
    },
    "EXT_OLLAMA_PORT": {
      "type": "integer",
      "description": "Ollama external port",
      "minimum": 1,
      "maximum": 65535,
      "default": 7804
    },
    "OPEN_INTERPRETER_PORT": {
      "type": "integer",
      "description": "Open Interpreter external port",
      "minimum": 1,
      "maximum": 65535,
      "default": 7805
    },
    "OPEN_INTERPRETER_API_KEY": {
      "type": "string",
      "description": "API key for authentication",
      "secret": true
    },
    "PAPERLESS_PORT": {
      "type": "integer",
      "description": "Paperless-ngx external port",
      "minimum": 1,
      "maximum": 65535,
      "default": 7807
    },
    "PAPERLESS_SECRET_KEY": {
      "type": "string",
      "description": "Django secret key for session security (auto-generated by setup.sh)",
      "secret": true
    },
    "PIPER_PORT": {
      "type": "integer",
      "description": "Piper TTS external port",
      "minimum": 1,
      "maximum": 65535,
      "default": 10200
    },
    "RVC_PORT": {
      "type": "integer",
      "description": "RVC external port",
      "minimum": 1,
      "maximum": 65535,
      "default": 7809
    },
    "SILLYTAVERN_PORT": {
      "type": "integer",
      "description": "SillyTavern external port",
      "minimum": 1,
      "maximum": 65535,
      "default": 8001
    },
    "TEXT_GEN_WEBUI_PORT": {
      "type": "integer",
      "description": "Text Generation WebUI external port",
      "minimum": 1,
      "maximum": 65535,
      "default": 7862
    },
    "WEAVIATE_PORT": {
      "type": "integer",
      "description": "Weaviate external port",
      "minimum": 1,
      "maximum": 65535,
      "default": 7811
    },
    "WEAVIATE_API_KEY": {
      "type": "string",
      "description": "API key for Weaviate authentication (auto-generated by setup.sh)",
      "secret": true
    },
    "XTTS_PORT": {
      "type": "integer",
      "description": "XTTS (Coqui TTS) external port",
      "minimum": 1,
      "maximum": 65535,
      "default": 8100
    },
    "DIFY_SECRET_KEY": {
      "type": "string",
      "description": "Dify secret key for API access",
      "secret": true
    },
    "LANGFUSE_PORT": {
      "type": "integer",
      "description": "Langfuse web UI external port",
      "default": 3006
    },
    "LANGFUSE_ENABLED": {
      "type": "boolean",
      "description": "Enable Langfuse LLM observability",
      "default": false
    },
    "LANGFUSE_NEXTAUTH_SECRET": {
      "type": "string",
      "description": "Langfuse NextAuth session signing secret",
      "secret": true
    },
    "LANGFUSE_SALT": {
      "type": "string",
      "description": "Langfuse password hashing salt",
      "secret": true
    },
    "LANGFUSE_ENCRYPTION_KEY": {
      "type": "string",
      "description": "Langfuse data encryption key",
      "secret": true
    },
    "LANGFUSE_DB_PASSWORD": {
      "type": "string",
      "description": "Langfuse PostgreSQL database password",
      "secret": true
    },
    "LANGFUSE_CLICKHOUSE_PASSWORD": {
      "type": "string",
      "description": "Langfuse ClickHouse database password",
      "secret": true
    },
    "LANGFUSE_REDIS_PASSWORD": {
      "type": "string",
      "description": "Langfuse Redis authentication password",
      "secret": true
    },
    "LANGFUSE_MINIO_ACCESS_KEY": {
      "type": "string",
      "description": "Langfuse MinIO S3 access key",
      "secret": true
    },
    "LANGFUSE_MINIO_SECRET_KEY": {
      "type": "string",
      "description": "Langfuse MinIO S3 secret key",
      "secret": true
    },
    "LANGFUSE_PROJECT_PUBLIC_KEY": {
      "type": "string",
      "description": "Langfuse project public API key"
    },
    "LANGFUSE_PROJECT_SECRET_KEY": {
      "type": "string",
      "description": "Langfuse project secret API key",
      "secret": true
    },
    "LANGFUSE_INIT_PROJECT_ID": {
      "type": "string",
      "description": "Langfuse initial project identifier"
    },
    "LANGFUSE_INIT_USER_EMAIL": {
      "type": "string",
      "description": "Langfuse initial admin user email",
      "default": "[email protected]",
      "secret": true
    },
    "LANGFUSE_INIT_USER_PASSWORD": {
      "type": "string",
      "description": "Langfuse initial admin user password",
      "secret": true
    },
    "ENABLE_IMAGE_GENERATION": {
      "type": "string",
      "description": "Enable image generation in Open WebUI (requires ComfyUI)",
      "default": "true"
    },
    "COMFYUI_BASE_URL": {
      "type": "string",
      "description": "ComfyUI address Open WebUI sends image prompts to (the bundled ComfyUI is http://comfyui:8188)",
      "default": "http://comfyui:8188"
    },
    "IMAGE_GENERATION_MODEL": {
      "type": "string",
      "description": "ComfyUI checkpoint for Open WebUI's built-in SDXL workflow",
      "default": "sdxl_lightning_4step.safetensors"
    },
    "IMAGE_SIZE": {
      "type": "string",
      "description": "Open WebUI image size as WIDTHxHEIGHT",
      "default": "1024x1024",
      "pattern": "^[1-9][0-9]{1,4}x[1-9][0-9]{1,4}$"
    },
    "IMAGE_STEPS": {
      "type": "integer",
      "description": "Open WebUI image sampling steps (SDXL Lightning 4-step is tuned for 4)",
      "default": 4,
      "minimum": 1,
      "maximum": 150
    },
    "GPU_COUNT": {
      "type": "integer",
      "description": "Number of GPUs detected at install time",
      "default": 1
    },
    "GPU_ASSIGNMENT_JSON_B64": {
      "type": "string",
      "description": "Base64-encoded GPU assignment JSON"
    },
    "SYSTEM_RAM_GB": {
      "type": "integer",
      "description": "System RAM budget recorded during install for model runtime profile matching. On WSL this is the VM-visible RAM after reserving control-plane headroom.",
      "minimum": 0
    },
    "LLAMA_SERVER_GPU_UUIDS": {
      "type": "string",
      "description": "GPU UUIDs assigned to llama-server (comma-separated, used by NVIDIA_VISIBLE_DEVICES)"
    },
    "LLAMA_REASONING": {
      "type": "string",
      "description": "llama.cpp reasoning/thinking mode: off (default) | auto | on, in any letter case. Off prevents thinking models from consuming the entire token budget on internal reasoning.",
      "enum": [
        "off", "auto", "on", "AUTO", "AUTo", "AUtO", "AUto",
        "AuTO", "AuTo", "AutO", "Auto", "OFF", "OFf", "ON",
        "OfF", "Off", "On", "aUTO", "aUTo", "aUtO", "aUto",
        "auTO", "auTo", "autO", "oFF", "oFf", "oN", "ofF"
      ],
      "default": "off"
    },
    "LLAMA_ARG_FLASH_ATTN": {
      "type": "string",
      "description": "llama.cpp Flash Attention mode. Use 'on' for long-context performance tuning when the selected backend supports it.",
      "enum": ["auto", "on", "off"],
      "default": "auto"
    },
    "LLAMA_ARG_CACHE_TYPE_K": {
      "type": "string",
      "description": "llama.cpp KV cache key type. q8_0 reduces long-context memory pressure versus f16.",
      "default": "f16"
    },
    "LLAMA_ARG_CACHE_TYPE_V": {
      "type": "string",
      "description": "llama.cpp KV cache value type. q8_0 reduces long-context memory pressure versus f16.",
      "default": "f16"
    },
    "LLAMA_ARG_N_CPU_MOE": {
      "type": "integer",
      "description": "Optional llama.cpp MoE tuning knob (--n-cpu-moe). Keeps the first N MoE expert layers on CPU/RAM. Leave unset for dense models.",
      "minimum": 0
    },
    "LLAMA_SERVER_GPU_INDICES": {
      "type": "string",
      "description": "GPU indices assigned to llama-server (comma-separated, used by ROCR_VISIBLE_DEVICES on AMD)"
    },
    "LLAMA_ARG_NO_CACHE_PROMPT": {
      "type": "string",
      "description": "Optional llama.cpp flag (--no-cache-prompt) used by specific long-context runtime profiles. Leave unset to keep prompt caching: in Docker, llama.cpp's negated-flag compatibility path treats any value, including 0, false or empty, as --no-cache-prompt.",
      "enum": ["", "0", "1", "false", "true", "off", "on"]
    },
    "LLAMA_ARG_CHECKPOINT_EVERY_NT": {
      "type": "integer",
      "description": "Optional llama.cpp --checkpoint-every-n-tokens (the env name llama.cpp reads). Context checkpoint interval during prefill; llama.cpp defaults to 8192, and -1 disables checkpoints."
    },
    "LLAMA_ARG_CHECKPOINT_EVERY_N_TOKENS": {
      "type": "integer",
      "description": "Deprecated and ignored: no llama.cpp build reads this name. Use LLAMA_ARG_CHECKPOINT_EVERY_NT. Retained so existing .env files still validate."
    },
    "LLAMA_ARG_CHECKPOINT_MIN_SPACING_NT": {
      "type": "integer",
      "description": "Optional llama.cpp --checkpoint-min-step (llama.cpp b9310 and later). Minimum token spacing between context checkpoints, not a fixed interval. Docker passes it through, but the pinned b9014 image ignores it; native runtimes validate it against the installed binary. Do not combine with LLAMA_ARG_CHECKPOINT_EVERY_NT.",
      "minimum": 0,
      "maximum": 262144
    },
    "LLAMA_ARG_CTX_CHECKPOINTS": {
      "type": "integer",
      "description": "llama.cpp --ctx-checkpoints: prompt checkpoints kept per slot, so a change earlier in a long conversation reuses the prompt before it instead of re-processing all of it. Native macOS uses 32 when unset (llama.cpp b8210 keeps 8; b9014 already defaults to 32). Each checkpoint holds model state in memory, about 50 MiB for Qwen3.5-9B; set a lower value, or 0 to disable, on a memory-constrained Mac. The Linux and Windows llama-server containers pass it through; CPU runtime profiles set 4.",
      "minimum": 0,
      "maximum": 64
    },
    "LLAMA_ARG_CACHE_RAM": {
      "type": "integer",
      "description": "llama.cpp --cache-ram: maximum prompt-cache size in MiB (b9014 default 8192; -1 no limit, 0 disables). CPU runtime profiles cap it so the cache fits the llama-server container; unset keeps the llama.cpp default.",
      "minimum": -1,
      "maximum": 1048576
    },
    "LLAMA_ARG_MMPROJ": {
      "type": "string",
      "description": "llama.cpp --mmproj: the vision projector the llama-server container loads (/models/<file>). Model activation sets it for an imported model that brings a projector and removes it for every other model; do not set it by hand.",
      "pattern": "^/models/[A-Za-z0-9._-]+\\.gguf$"
    },
    "LLAMA_ARG_CHAT_TEMPLATE_FILE": {
      "type": "string",
      "description": "llama.cpp --chat-template-file: the fixed chat template the llama-server container loads (/chat-templates/upstream-b<build>/<name>.jinja, mounted read-only from config/chat-templates). Model activation sets it with MODEL_CHAT_TEMPLATE_OVERRIDE and removes it for every other model; do not set it by hand.",
      "pattern": "^/chat-templates/upstream-b[0-9]+/[A-Za-z0-9][A-Za-z0-9._-]*\\.jinja$"
    },
    "LLAMA_PARALLEL": {
      "type": "integer",
      "description": "llama.cpp --parallel request slots. Advanced 8GB MoE profiles keep this at 1 to preserve VRAM headroom.",
      "minimum": 1,
      "default": 1
    },
    "LLAMA_ARG_SPEC_TYPE": {
      "type": "string",
      "description": "Optional per-model llama.cpp speculative decoding mode (--spec-type), normally written by a model runtime profile. Overrides LLAMA_SPEC_TYPE when set. Use only with a llama.cpp build and GGUF that explicitly support the selected mode, e.g. draft-mtp or ngram-mod,draft-mtp."
    },
    "LLAMA_SPEC_TYPE": {
      "type": "string",
      "description": "Default llama.cpp speculative decoding for the NVIDIA and CPU Docker overlays and native macOS (pinned llama.cpp b9014) when the active model sets no LLAMA_ARG_SPEC_TYPE. Unset means ngram-mod: lossless n-gram drafting verified by the model, which speeds up edits and rewrites that repeat context. Set none to turn it off. Native macOS applies it only when the installed llama-server has the b8955+ ngram-mod implementation. Not applied to AMD, Intel/Arc, Apple Docker, native Windows or registered model-store profiles.",
      "enum": ["", "ngram-mod", "ngram-simple", "ngram-map-k", "ngram-map-k4v", "ngram-cache", "none"],
      "default": "ngram-mod"
    },
    "LLAMA_ARG_SPEC_DRAFT_TYPE_K": {
      "type": "string",
      "description": "Optional speculative draft key cache type for native llama-server launches (macOS, Windows), passed as --spec-draft-type-k. llama.cpp has no env var by this name, so Docker ignores it; use LLAMA_ARG_SPEC_DRAFT_CACHE_TYPE_K there."
    },
    "LLAMA_ARG_SPEC_DRAFT_TYPE_V": {
      "type": "string",
      "description": "Optional speculative draft value cache type for native llama-server launches (macOS, Windows), passed as --spec-draft-type-v. llama.cpp has no env var by this name, so Docker ignores it; use LLAMA_ARG_SPEC_DRAFT_CACHE_TYPE_V there."
    },
    "LLAMA_ARG_SPEC_DRAFT_CACHE_TYPE_K": {
      "type": "string",
      "description": "Optional draft-model key cache type for Docker llama-server (--spec-draft-type-k; the env name llama.cpp b9014 reads). Leave unset unless a draft model or MTP is in use; llama.cpp defaults to f16."
    },
    "LLAMA_ARG_SPEC_DRAFT_CACHE_TYPE_V": {
      "type": "string",
      "description": "Optional draft-model value cache type for Docker llama-server (--spec-draft-type-v; the env name llama.cpp b9014 reads). Leave unset unless a draft model or MTP is in use; llama.cpp defaults to f16."
    },
    "LLAMA_ARG_SPEC_DRAFT_N_MAX": {
      "type": "integer",
      "description": "Optional llama.cpp speculative draft token cap (--spec-draft-n-max). For current MTP-capable GGUFs this is commonly tuned by benchmark; leave unset for normal models.",
      "minimum": 1
    },
    "LLAMA_ARG_SPLIT_MODE": {
      "type": "string",
      "description": "llama.cpp split mode (LLAMA_ARG_SPLIT_MODE): none | layer | row. Installers use layer for pipeline, tensor and hybrid GPU assignments on NVIDIA and AMD: CUDA row split fails to load models from llama.cpp b9890, and Vulkan has no row split."
    },
    "LLAMA_ARG_TENSOR_SPLIT": {
      "type": "string",
      "description": "llama.cpp tensor split weights (LLAMA_ARG_TENSOR_SPLIT): comma-separated proportions e.g. 3,1"
    },
    "EMBEDDINGS_GPU_UUID": {
      "type": "string",
      "description": "GPU UUID assigned to embeddings service (NVIDIA)"
    },
    "EMBEDDINGS_GPU_INDEX": {
      "type": "integer",
      "description": "GPU index for embeddings service (AMD, used as ROCR_VISIBLE_DEVICES)",
      "default": 0
    },
    "COMFYUI_GPU_UUID": {
      "type": "string",
      "description": "GPU UUID assigned to ComfyUI (NVIDIA)"
    },
    "COMFYUI_GPU_INDEX": {
      "type": "integer",
      "description": "GPU index for ComfyUI (AMD, used as ROCR_VISIBLE_DEVICES)",
      "default": 0
    },
    "WHISPER_GPU_UUID": {
      "type": "string",
      "description": "GPU UUID assigned to Whisper (NVIDIA)"
    },
    "WHISPER_GPU_INDEX": {
      "type": "integer",
      "description": "GPU index for Whisper service (AMD, used as ROCR_VISIBLE_DEVICES)",
      "default": 0
    },
    "ROCR_VISIBLE_DEVICES": {
      "type": "string",
      "description": "AMD GPU indices visible to ROCm runtime (comma-separated, e.g. '0,1,2')"
    },
    "LEMONADE_LLAMACPP": {
      "type": "string",
      "description": "Retired: the Lemonade runtime was removed (AMD now runs llama.cpp); ignored if present.",
      "enum": ["auto", "vulkan", "cpu"],
      "deprecated": true
    },
    "LEMONADE_LLAMACPP_ROCM_BIN": {
      "type": "string",
      "description": "Retired: the Lemonade runtime was removed (AMD now runs llama.cpp); ignored if present.",
      "deprecated": true
    },
    "LLM_MODEL_SIZE_MB": {
      "type": "integer",
      "description": "Approximate model file size in MB (used for multi-GPU memory planning)"
    },
    "LITELLM_MASTER_KEY": {
      "type": "string",
      "description": "LiteLLM master API key for proxy authentication",
      "secret": true
    },
    "APE_PORT": {
      "type": "integer",
      "description": "Agent Policy Engine port",
      "default": 7890
    },
    "APE_RATE_LIMIT_RPM": {
      "type": "integer",
      "description": "APE per-minute policy check rate limit.",
      "default": 60,
      "minimum": 1
    },
    "APE_STRICT_MODE": {
      "type": "string",
      "description": "When true, APE blocks policy violations instead of only logging advisory decisions.",
      "enum": ["true", "false"],
      "default": "false"
    },
    "OPENCLAW_API_KEY": {
      "type": "string",
      "description": "Retired: the legacy OpenClaw extension was removed; ignored if present.",
      "secret": true,
      "clearable": true,
      "deprecated": true
    },
    "OPENCLAW_CONFIG": {
      "type": "string",
      "description": "Retired: the legacy OpenClaw extension was removed; ignored if present.",
      "deprecated": true
    },
    "OPENCLAW_LLM_URL": {
      "type": "string",
      "description": "Retired: the legacy OpenClaw extension was removed; ignored if present.",
      "deprecated": true
    },
    "OPENCLAW_HTTP_API": {
      "type": "string",
      "description": "Retired: the legacy OpenClaw extension was removed; ignored if present.",
      "deprecated": true
    },
    "ODS_AGENT_BIND": {
      "type": "string",
      "description": "Bind address for the ODS Host Agent HTTP server. Defaults to 127.0.0.1 on macOS/Windows, ods-network gateway IP on Linux, then Docker bridge gateway, then 127.0.0.1.",
      "default": ""
    },
    "ODS_AGENT_PORT": {
      "type": "integer",
      "description": "Host Agent HTTP port used by dashboard-api to request privileged host operations such as .env writes and service recreation.",
      "default": 7710,
      "minimum": 1,
      "maximum": 65535
    },
    "ODS_AGENT_ADDRESS_MODE": {
      "type": "string",
      "enum": ["", "wsl-nat", "wsl-nat-loopback", "wsl-nat-bridge"],
      "default": "",
      "description": "Installer-managed WSL NAT address marker. Docker Desktop installs bind the host agent to the private WSL eth0 address; a Windows loopback relay connects host.docker.internal to it. Legacy managed values migrate on reinstall. Unmarked operator bind and host values are preserved."
    },
    "ODS_AGENT_HOST": {
      "type": "string",
      "description": "Hostname or IP that dashboard-api containers use to reach the ODS Host Agent. Docker Desktop uses host.docker.internal; Colima uses its private vmnet host gateway.",
      "default": ""
    },
    "ODS_PYTHON_CMD": {
      "type": "string",
      "description": "Python interpreter that ODS shell helpers must use, recorded by the installer when the host python3 cannot import yaml (the compose resolver requires PyYAML). Empty means detect at runtime.",
      "default": ""
    },
    "ODS_MACOS_HOST_GATEWAY": {
      "type": "string",
      "description": "Private macOS host-side vmnet address used by Colima containers to reach loopback-only ODS services.",
      "default": ""
    },
    "ODS_MACOS_VM_IP": {
      "type": "string",
      "description": "Colima VM address authorized to connect to the private macOS host-service bridges.",
      "default": ""
    },
    "ODS_MACOS_LLM_BRIDGE_ENABLED": {
      "type": "string",
      "description": "Whether the private Colima-to-native-llama bridge is managed by the macOS installer.",
      "enum": ["", "true", "false"],
      "default": ""
    },
    "ODS_MACOS_HOST_AGENT_BRIDGE_ENABLED": {
      "type": "string",
      "description": "Whether the private Colima-to-host-agent bridge is managed by the macOS installer.",
      "enum": ["", "true", "false"],
      "default": ""
    },
    "ODS_NATIVE_LLAMA_PORT": {
      "type": "integer",
      "description": "Loopback-only native llama-server port behind the macOS Colima bridge.",
      "default": 8080,
      "minimum": 1,
      "maximum": 65535
    },
    "ODS_TIER": {
      "type": "string",
      "description": "Hardware tier classification (0-4, SH_LARGE, SH_COMPACT, NV_ULTRA, CLOUD)"
    },
    "HW_CLASS": {
      "type": "string",
      "description": "Hardware class identifier from capability profile"
    },
    "OPEN_WEBUI_PORT": {
      "type": "integer",
      "description": "Open WebUI external port",
      "default": 3000
    },
    "PRIVACY_SHIELD_PORT": {
      "type": "integer",
      "description": "Privacy Shield PII proxy port",
      "default": 8085
    },
    "LIVEKIT_PORT": {
      "type": "integer",
      "description": "LiveKit voice server port",
      "default": 7880
    },
    "LANGFUSE_NEXTAUTH_URL": {
      "type": "string",
      "description": "Langfuse NextAuth callback URL"
    },
    "LANGFUSE_POSTGRES_PASSWORD": {
      "type": "string",
      "description": "Langfuse PostgreSQL password",
      "secret": true
    },
    "LANGFUSE_POSTGRES_PORT": {
      "type": "integer",
      "description": "Langfuse PostgreSQL port",
      "default": 5433
    },
    "LANGFUSE_CLICKHOUSE_PORT": {
      "type": "integer",
      "description": "Langfuse ClickHouse native port"
    },
    "LANGFUSE_CLICKHOUSE_HTTP": {
      "type": "integer",
      "description": "Langfuse ClickHouse HTTP port"
    },
    "LANGFUSE_REDIS_PORT": {
      "type": "integer",
      "description": "Langfuse Redis port"
    },
    "LANGFUSE_MINIO_PORT": {
      "type": "integer",
      "description": "Langfuse MinIO S3 port"
    },
    "LANGFUSE_MINIO_CONSOLE_PORT": {
      "type": "integer",
      "description": "Langfuse MinIO console port"
    },
    "LANGFUSE_MINIO_ROOT_USER": {
      "type": "string",
      "description": "Langfuse MinIO root username",
      "secret": true
    },
    "LANGFUSE_MINIO_ROOT_PASSWORD": {
      "type": "string",
      "description": "Langfuse MinIO root password",
      "secret": true
    },
    "LANGFUSE_TELEMETRY_ENABLED": {
      "type": "string",
      "description": "Enable/disable Langfuse telemetry",
      "default": "false"
    },
    "ODS_SESSION_SECRET": {
      "type": "string",
      "description": "HMAC signing secret for the ods-session cookie. dashboard-api uses this to sign at magic-link redemption; the Hermes auth-proxy uses /api/auth/verify-session to validate. Generate with `openssl rand -hex 32`. Rotating kicks all current sessions.",
      "secret": true
    },
    "HERMES_DASHBOARD_SESSION_TOKEN": {
      "type": "string",
      "description": "Internal Hermes dashboard and WebSocket session token. The installer generates and preserves it so browser sessions survive Hermes container restarts.",
      "secret": true,
      "minLength": 32
    },
    "ODS_PUBLIC_URL": {
      "type": "string",
      "description": "Public base URL used by dashboard-api when generating invite and magic-link URLs for custom domains, tunnels, or Tailscale Funnel. Leave empty for normal mDNS/LAN URL generation."
    },
    "ODS_SERVICE_PUBLIC_URLS": {
      "type": "string",
      "description": "Optional JSON object mapping service ids to their public browser URLs when an external reverse proxy is used, for example {\"open-webui\":\"https://chat.example.com\",\"comfyui\":\"https://comfy.example.com\"}."
    },
    "ODS_CHAT_PUBLIC_URL": {
      "type": "string",
      "description": "Optional public chat redirect URL for magic-link redemption. Defaults to OPEN_WEBUI_PUBLIC_URL or ODS_PUBLIC_URL/chat when public mode is used."
    },
    "ODS_HERMES_PUBLIC_URL": {
      "type": "string",
      "description": "Optional public Hermes redirect URL for magic-link redemption. Defaults to HERMES_PROXY_PUBLIC_URL or ODS_PUBLIC_URL/hermes when public mode is used."
    },
    "ODS_TALK_PUBLIC_URL": {
      "type": "string",
      "description": "Optional public ODS Talk redirect URL for owner-card magic links. Defaults to ODS_PUBLIC_URL/talk when public mode is used."
    },
    "OPEN_WEBUI_PUBLIC_URL": {
      "type": "string",
      "description": "Optional public browser URL for Open WebUI when served through an external reverse proxy."
    },
    "COMFYUI_PUBLIC_URL": {
      "type": "string",
      "description": "Optional public browser URL for ComfyUI when served through an external reverse proxy."
    },
    "N8N_PUBLIC_URL": {
      "type": "string",
      "description": "Optional public browser URL for n8n when served through an external reverse proxy."
    },
    "HERMES_PROXY_PUBLIC_URL": {
      "type": "string",
      "description": "Optional public browser URL for Hermes proxy when served through an external reverse proxy."
    },
    "WHISPER_PUBLIC_URL": {
      "type": "string",
      "description": "Optional public browser URL for Whisper STT when served through an external reverse proxy."
    },
    "TTS_PUBLIC_URL": {
      "type": "string",
      "description": "Optional public browser URL for Kokoro TTS when served through an external reverse proxy."
    },
    "OPENCODE_PUBLIC_URL": {
      "type": "string",
      "description": "Optional public browser URL for OpenCode when served through an external reverse proxy."
    },
    "ODS_COOKIE_DOMAIN": {
      "type": "string",
      "description": "Cookie domain for ods-session SSO across dashboard/chat/auth/hermes subdomains. Empty keeps cookies host-only; proxy installs commonly use <device>.local."
    },
    "ODS_PROXY_PORT": {
      "type": "integer",
      "description": "Host port for the ODS reverse proxy (Caddy). Default 80 — standard HTTP. The proxy is opt-in via `ods enable ods-proxy`.",
      "default": 80
    },
    "ODS_PROXY_TLS_PORT": {
      "type": "integer",
      "description": "Host port for HTTPS (deferred; HTTP only in v1). Default 443.",
      "default": 443
    },
    "ODS_PROXY_BIND": {
      "type": "string",
      "description": "Bind address for the reverse proxy's host port. Defaults to 0.0.0.0 (LAN-exposed) — that's the whole point of the proxy. Override to 127.0.0.1 to keep it localhost-only.",
      "default": "0.0.0.0"
    },
    "HERMES_LLM_BASE_URL": {
      "type": "string",
      "description": "OpenAI-compatible endpoint Hermes Agent talks to. Defaults to ODS's llama-server.",
      "default": "http://llama-server:8080/v1"
    },
    "HERMES_LLM_API_KEY": {
      "type": "string",
      "description": "Dummy API key for Hermes Agent's OpenAI SDK (llama-server doesn't validate it, but the SDK requires the field to be non-empty).",
      "secret": true
    },
    "HERMES_AGENT_IMAGE": {
      "type": "string",
      "description": "Container image used for Hermes Agent. Defaults to a reviewed upstream version tag; override only for deliberate hotfix testing.",
      "default": "nousresearch/hermes-agent:v2026.9.24@sha256:fca358f12efd65bfaaca05884166f15c0e2788375ca30d77061ac1ebc96452b7"
    },
    "HERMES_AGENT_IMAGE_FALLBACK": {
      "type": "string",
      "description": "Optional explicit fallback Hermes Agent image. Phase 08 uses it only if HERMES_AGENT_IMAGE cannot be resolved.",
      "default": ""
    },
    "HERMES_LANGUAGE": {
      "type": "string",
      "description": "UI language for Hermes Agent's web dashboard (defaults to en).",
      "default": "en"
    },
    "SEARXNG_URL": {
      "type": "string",
      "description": "SearXNG URL used by Hermes web tools. Defaults to the bundled searxng service on the Docker network.",
      "default": "http://searxng:8080"
    },
    "WHATSAPP_ENABLED": {
      "type": "string",
      "description": "Enable Hermes's optional WhatsApp gateway integration. Disabled by default.",
      "enum": ["", "true", "false"],
      "default": "false"
    },
    "WHATSAPP_MODE": {
      "type": "string",
      "description": "Hermes WhatsApp gateway mode.",
      "default": "self-chat"
    },
    "WHATSAPP_ALLOWED_USERS": {
      "type": "string",
      "description": "Comma-separated WhatsApp user IDs or phone numbers allowed to talk to Hermes."
    },
    "WHATSAPP_REQUIRE_MENTION": {
      "type": "string",
      "description": "Require a mention/prefix before Hermes replies in WhatsApp chats.",
      "enum": ["", "true", "false"],
      "default": ""
    },
    "WHATSAPP_FREE_RESPONSE_CHATS": {
      "type": "string",
      "description": "Comma-separated WhatsApp chat IDs where Hermes may respond without an explicit mention."
    },
    "WHATSAPP_REPLY_PREFIX": {
      "type": "string",
      "description": "Optional prefix added to Hermes WhatsApp replies."
    },
    "HERMES_REQUIRE_OWNER_CARD": {
      "type": "boolean",
      "description": "Require a signed ODS owner-card or guest session before opening Hermes. Default installs open Hermes directly; ODS Talk and dashboard authentication are unchanged.",
      "default": false
    },
    "HERMES_PROXY_PORT": {
      "type": "integer",
      "description": "External port for the Hermes proxy; owner-card session gating is optional.",
      "default": 9120
    },
    "HERMES_PROXY_UPSTREAM": {
      "type": "string",
      "description": "Internal upstream the Hermes auth-proxy forwards to. Defaults to ods-hermes:9119.",
      "default": "ods-hermes:9119"
    },
    "ODS_AUTH_UPSTREAM": {
      "type": "string",
      "description": "Where Caddy forward_auth sends its session-verify sub-request. Defaults to the in-network dashboard-api container; override if dashboard-api lives elsewhere.",
      "default": "ods-dashboard-api:3002"
    },
    "HERMES_PROXY_AUTH_DOCS_URL": {
      "type": "string",
      "description": "Optional docs/help URL shown on the Hermes auth-required page when a visitor lacks a valid ods-session cookie."
    },
    "TS_AUTHKEY": {
      "type": "string",
      "description": "Tailscale auth key (tskey-auth-...). Generate at https://login.tailscale.com/admin/settings/keys. Consumed once on first join; the daemon caches the node key in data/tailscale/.",
      "secret": true
    },
    "TS_HOSTNAME": {
      "type": "string",
      "description": "Hostname this device registers as on the Tailscale net. Defaults to ODS_DEVICE_NAME. Reachable as <hostname>.<tailnet>.ts.net once joined.",
      "pattern": "^[a-z0-9]([a-z0-9-]{0,30}[a-z0-9])?$"
    },
    "TS_EXTRA_ARGS": {
      "type": "string",
      "description": "Optional extra flags passed to `tailscale up`, such as --advertise-tags=tag:ods after your tailnet ACL defines and authorizes that tag."
    },
    "OFFLINE_MODE": {
      "type": "boolean",
      "description": "Air-gapped operation. install-core.sh defaults this to false and --offline sets it true; phase 09 then appends this block to .env.",
      "default": false
    },
    "DISABLE_TELEMETRY": {
      "type": "boolean",
      "description": "Suppress telemetry for an air-gapped install. Written as true by phase 09 under --offline.",
      "default": false
    },
    "DISABLE_UPDATE_CHECK": {
      "type": "boolean",
      "description": "Suppress update checks for an air-gapped install. Written as true by phase 09 under --offline.",
      "default": false
    },
    "WEB_SEARCH_ENABLED": {
      "type": "boolean",
      "description": "Allow web search. Phase 09 writes false under --offline so the stack does not reach the network.",
      "default": true
    },
    "LOCAL_RAG_ENABLED": {
      "type": "boolean",
      "description": "Prefer local RAG over web search. Phase 09 writes true under --offline.",
      "default": false
    },
    "MINIFLUX_PORT": {
      "type": "integer",
      "description": "Miniflux external port",
      "minimum": 1,
      "maximum": 65535,
      "default": 8098
    },
    "NTFY_PORT": {
      "type": "integer",
      "description": "ntfy external port",
      "minimum": 1,
      "maximum": 65535,
      "default": 8097
    },
    "MINIFLUX_BASE_URL": {
      "type": "string",
      "description": "Miniflux client-facing URL; update when changing the published port or hostname"
    },
    "NTFY_BASE_URL": {
      "type": "string",
      "description": "ntfy client-facing URL; update when changing the published port or hostname"
    },
    "MINIFLUX_DB_PASSWORD": {
      "type": "string",
      "description": "Password for the private PostgreSQL database; retain after initialization",
      "secret": true
    },
    "MINIFLUX_ADMIN_PASSWORD": {
      "type": "string",
      "description": "Initial Miniflux admin password; later changes use the Miniflux UI",
      "secret": true
    },
    "BRAVE_SEARCH_SEARXNG_COMPAT": {
      "type": "string",
      "description": "Set to 1 to expose a searxng-compatible /search?format=json route for consumers like Perplexica"
    },
    "PERPLEXICA_SEARXNG_API_URL": {
      "type": "string",
      "description": "Explicit SearXNG-compatible search endpoint; leave empty to preserve Perplexica's current setting"
    },
    "PIXEL_INGRESS_SOCKET": {
      "type": "string",
      "description": "Unix-domain socket path the ingress listens on. UDS only, never TCP."
    },
    "PIXEL_GATEWAY_TOKEN_FILE": {
      "type": "string",
      "description": "Restricted owner-private OpenClaw config containing the gateway token."
    },
    "PIXEL_STATUS_FILE": {
      "type": "string",
      "description": "Sanitized status projection path written on startup and interval."
    },
    "PIXEL_STATUS_INTERVAL_MS": {
      "type": "string",
      "description": "Interval in ms between status projection writes."
    },
    "ODS_REMOTE_PROVIDER_ROUTE_PATH": {
      "type": "string",
      "description": "Generated remote routing-state path mounted read-only into the egress service."
    },
    "ODS_REMOTE_PROVIDER_POLICY_PATH": {
      "type": "string",
      "description": "Versioned egress policy document mounted read-only into the egress service."
    },
    "ODS_REMOTE_PROVIDER_API_KEY_FILE": {
      "type": "string",
      "description": "Private provider bearer token file. The value is never projected into public env/config."
    },
    "ODS_REMOTE_PROVIDER_SSH_TUNNEL_HEALTH_URL": {
      "type": "string",
      "description": "Internal SSH tunnel readiness endpoint used only for SSH transport health gating."
    },
    "ODS_REMOTE_PROVIDER_SSH_TUNNEL_HEALTH_TIMEOUT": {
      "type": "string",
      "description": "Seconds the egress service waits for the internal SSH tunnel health endpoint."
    },
    "ODS_REMOTE_PROVIDER_SECRET_DIR": {
      "type": "string",
      "description": "Private SSH identity and known_hosts custody directory mounted read-only into the SSH tunnel service."
    },
    "ODS_REMOTE_PROVIDER_SSH_STATUS_PORT": {
      "type": "string",
      "description": "Internal-only health/status port for the SSH tunnel supervisor scaffold."
    },
    "ODS_REMOTE_PROVIDER_SSH_RECONCILE_INTERVAL": {
      "type": "string",
      "description": "Seconds between route/secret custody reconciliation loops."
    },
    "ODS_REMOTE_PROVIDER_SSH_START_GRACE": {
      "type": "string",
      "description": "Seconds a newly started SSH child must stay alive before health reports ready."
    },
    "ODS_REMOTE_PROVIDER_SSH_RESTART_COOLDOWN": {
      "type": "string",
      "description": "Seconds to wait before restarting an exited SSH child."
    },
    "ODS_REMOTE_PROVIDER_SSH_STOP_TIMEOUT": {
      "type": "string",
      "description": "Seconds to wait for an old SSH child to terminate before killing it."
    },
    "ACTUAL_BUDGET_PORT": {
      "type": "integer",
      "description": "Actual Budget published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11046
    },
    "APACHE_ANSWER_PORT": {
      "type": "integer",
      "description": "Apache Answer published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11147
    },
    "AUDIOBOOKSHELF_PORT": {
      "type": "integer",
      "description": "Audiobookshelf published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11047
    },
    "AUDIOMASS_PORT": {
      "type": "integer",
      "description": "AudioMass published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11079
    },
    "BACKREST_PORT": {
      "type": "integer",
      "description": "Backrest published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11108
    },
    "BARK_USE_SMALL_MODELS": {
      "type": "string",
      "description": "Use smaller/faster Bark models (less VRAM, slightly lower quality)"
    },
    "BARK_OFFLOAD_CPU": {
      "type": "string",
      "description": "Offload Bark models to CPU between requests (reduces VRAM usage)"
    },
    "BARK_API_KEY": {
      "type": "string",
      "description": "API key for Bark TTS service authentication (optional; leave empty to disable auth)"
    },
    "BENTOPDF_PORT": {
      "type": "integer",
      "description": "BentoPDF published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11006
    },
    "BLOCKBENCH_PORT": {
      "type": "integer",
      "description": "Blockbench published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11076
    },
    "BOOKSTACK_PORT": {
      "type": "integer",
      "description": "BookStack published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11148
    },
    "BOOKSTACK_APP_KEY": {
      "type": "string",
      "description": "Stable Laravel encryption key, base64 followed by a colon and base64 encoding of 32 random bytes. Preserve it with backups.",
      "secret": true
    },
    "BOOKSTACK_DB_PASSWORD": {
      "type": "string",
      "description": "Dedicated database password. Use at least 24 random alphanumeric characters; preserve it after initialization.",
      "secret": true
    },
    "BOOKSTACK_URL": {
      "type": "string",
      "description": "Browser origin including port, normally http://localhost:11148. Changing this later requires BookStack URL migration."
    },
    "CHANGEDETECTION_PORT": {
      "type": "integer",
      "description": "changedetection.io published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11039
    },
    "CHANGEDETECTION_PASSWORD": {
      "type": "string",
      "description": "Required web login password, converted in memory to upstream salted PBKDF2 format on startup.",
      "secret": true
    },
    "CHANGEDETECTION_BASE_URL": {
      "type": "string",
      "description": "Browser URL used for links; adjust if publishing on a different local port."
    },
    "CHANGEDETECTION_TIMEZONE": {
      "type": "string",
      "description": "IANA timezone for user-configured watch schedules."
    },
    "CHARTDB_PORT": {
      "type": "integer",
      "description": "ChartDB published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11042
    },
    "CLICKHOUSE_PORT": {
      "type": "integer",
      "description": "ClickHouse published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11036
    },
    "CLICKHOUSE_PASSWORD": {
      "type": "string",
      "description": "Strong password for the local ods database user. Keep with configuration backups.",
      "secret": true
    },
    "CLOUDBEAVER_PORT": {
      "type": "integer",
      "description": "CloudBeaver Community published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11057
    },
    "CODE_SERVER_PORT": {
      "type": "integer",
      "description": "code-server published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11030
    },
    "CODE_SERVER_PASSWORD": {
      "type": "string",
      "description": "Strong password required to access the editor and its container terminal.",
      "secret": true
    },
    "CONVERTX_PORT": {
      "type": "integer",
      "description": "ConvertX published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11085
    },
    "CONVERTX_JWT_SECRET": {
      "type": "string",
      "description": "Persistent random login-token signing secret; use at least 32 random characters.",
      "secret": true
    },
    "COUCHDB_PORT": {
      "type": "integer",
      "description": "Apache CouchDB published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11045
    },
    "COUCHDB_PASSWORD": {
      "type": "string",
      "description": "Initial password for the ods administrator. Use a single-line password; later changes are managed in CouchDB and persisted.",
      "secret": true
    },
    "CRAWL4AI_PORT": {
      "type": "integer",
      "description": "Crawl4AI published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11002
    },
    "CYBERCHEF_PORT": {
      "type": "integer",
      "description": "CyberChef published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11028
    },
    "DATASETTE_PORT": {
      "type": "integer",
      "description": "Datasette published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11117
    },
    "DIFY_EXTERNAL_URL": {
      "type": "string",
      "description": "External URL for Dify - used in API responses and redirects"
    },
    "DIFY_OPENAI_API_BASE": {
      "type": "string",
      "description": "OpenAI-compatible API endpoint for LLM backend"
    },
    "DIFY_OPENAI_API_KEY": {
      "type": "string",
      "description": "API key for OpenAI-compatible endpoint",
      "secret": true
    },
    "DIFY_INIT_PASSWORD": {
      "type": "string",
      "description": "Initial admin password (optional, set in .env)"
    },
    "DISTRIBUTION_PORT": {
      "type": "integer",
      "description": "CNCF Distribution published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11136
    },
    "DISTRIBUTION_PASSWORD": {
      "type": "string",
      "description": "Random 64-hex password for local registry user ods; reapplied on startup.",
      "secret": true
    },
    "DISTRIBUTION_HTTP_SECRET": {
      "type": "string",
      "description": "Distinct stable random 64-hex secret for registry upload state.",
      "secret": true
    },
    "DOCLING_SERVE_PORT": {
      "type": "integer",
      "description": "Docling Serve published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11000
    },
    "DOCUSEAL_PORT": {
      "type": "integer",
      "description": "DocuSeal published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11084
    },
    "DOCUSEAL_SECRET_KEY_BASE": {
      "type": "string",
      "description": "Stable random application secret: generate 64 random bytes as 128 hex characters and preserve it with backups.",
      "secret": true
    },
    "DOKUWIKI_PORT": {
      "type": "integer",
      "description": "DokuWiki published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11065
    },
    "DRAWIO_PORT": {
      "type": "integer",
      "description": "draw.io published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11009
    },
    "DUFS_HTTP_PORT": {
      "type": "integer",
      "description": "Dufs published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11069
    },
    "DUFS_PASSWORD": {
      "type": "string",
      "description": "Password for ods, at least 12 bytes; exclude colon, at-sign, pipe, line breaks and crypt-hash prefix.",
      "secret": true
    },
    "ETHERPAD_PORT": {
      "type": "integer",
      "description": "Etherpad published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11070
    },
    "ETHERPAD_ADMIN_PASSWORD": {
      "type": "string",
      "description": "Password for the admin account.",
      "secret": true
    },
    "ETHERPAD_USER_PASSWORD": {
      "type": "string",
      "description": "Password for the non-administrator user account.",
      "secret": true
    },
    "ETHERPAD_DATABASE_PASSWORD": {
      "type": "string",
      "description": "Persistent dedicated PostgreSQL password.",
      "secret": true
    },
    "ETHERPAD_ADMIN_SECRET": {
      "type": "string",
      "description": "Random secret for the built-in admin OAuth client.",
      "secret": true
    },
    "ETHERPAD_USER_SECRET": {
      "type": "string",
      "description": "Independent random secret for the built-in user OAuth client.",
      "secret": true
    },
    "EVIDENTLY_PORT": {
      "type": "integer",
      "description": "Evidently published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11016
    },
    "EVIDENTLY_SECRET": {
      "type": "string",
      "description": "Secret required by SDK clients to write evaluation reports.",
      "secret": true
    },
    "EXCALIDRAW_PORT": {
      "type": "integer",
      "description": "Excalidraw published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11010
    },
    "FILEBROWSER_QUANTUM_PORT": {
      "type": "integer",
      "description": "FileBrowser Quantum published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11041
    },
    "FILEBROWSER_QUANTUM_ADMIN_PASSWORD": {
      "type": "string",
      "description": "Initial password for the admin account; use the application account controls for later changes.",
      "secret": true
    },
    "FILEBROWSER_QUANTUM_JWT_SECRET": {
      "type": "string",
      "description": "Persistent random signing secret for login tokens; at least 32 random characters recommended.",
      "secret": true
    },
    "FLARUM_PORT": {
      "type": "integer",
      "description": "Flarum published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11133
    },
    "FLARUM_DB_PASSWORD": {
      "type": "string",
      "description": "Stable random 64-hex database password; changing environment alone does not rotate an initialized database.",
      "secret": true
    },
    "FRESHRSS_PORT": {
      "type": "integer",
      "description": "FreshRSS published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11029
    },
    "FRESHRSS_TIMEZONE": {
      "type": "string",
      "description": "IANA timezone for feed refresh scheduling."
    },
    "FRESHRSS_CRON_MIN": {
      "type": "string",
      "description": "Minutes within each hour for refresh; default twice hourly."
    },
    "GAIA_AGENT_UI_VERSION": {
      "type": "string",
      "description": "Retired: the AMD GAIA library recipe was removed; only a GAIA copy installed before then still reads it.",
      "deprecated": true
    },
    "GAIA_LEMONADE_BASE_URL": {
      "type": "string",
      "description": "Retired: the AMD GAIA library recipe was removed; only a GAIA copy installed before then still reads it.",
      "deprecated": true
    },
    "GAIA_SKIP_GAIA_INIT": {
      "type": "string",
      "description": "Retired: the AMD GAIA library recipe was removed; only a GAIA copy installed before then still reads it.",
      "deprecated": true
    },
    "GAIA_UI_SERVE_ONLY": {
      "type": "string",
      "description": "Retired: the AMD GAIA library recipe was removed; only a GAIA copy installed before then still reads it.",
      "deprecated": true
    },
    "GAIA_DISABLE_UPDATE": {
      "type": "string",
      "description": "Retired: the AMD GAIA library recipe was removed; only a GAIA copy installed before then still reads it.",
      "deprecated": true
    },
    "GARAGE_PORT": {
      "type": "integer",
      "description": "Garage S3 published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11116
    },
    "GARAGE_RPC_SECRET": {
      "type": "string",
      "description": "Stable 64-hex node RPC secret; preserve with the metadata backup.",
      "secret": true
    },
    "GATUS_PORT": {
      "type": "integer",
      "description": "Gatus published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11064
    },
    "GATUS_ENDPOINT": {
      "type": "string",
      "description": "HTTP(S) endpoint reachable from the container that should return 200. No embedded credentials."
    },
    "GITEA_HOST": {
      "type": "string",
      "description": "Hostname for Gitea server"
    },
    "GITEA_SSH_PORT": {
      "type": "string",
      "description": "External port for Gitea SSH access"
    },
    "GITEA_APP_NAME": {
      "type": "string",
      "description": "Display name for the Gitea instance"
    },
    "GO_HTTPBIN_PORT": {
      "type": "integer",
      "description": "go-httpbin published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11044
    },
    "GOTENBERG_PORT": {
      "type": "integer",
      "description": "Gotenberg published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11017
    },
    "GOTIFY_PORT": {
      "type": "integer",
      "description": "Gotify published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11073
    },
    "GOTIFY_ADMIN_PASSWORD": {
      "type": "string",
      "description": "Initial administrator password; existing accounts are not reset by changing this value.",
      "secret": true
    },
    "GRAFANA_PORT": {
      "type": "integer",
      "description": "Grafana OSS published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11100
    },
    "GRAFANA_ADMIN_PASSWORD": {
      "type": "string",
      "description": "64-hex initial administrator password for ods; existing users are not reset.",
      "secret": true
    },
    "GRAFANA_SECRET_KEY": {
      "type": "string",
      "description": "Distinct stable 64-hex key protecting stored data-source credentials; preserve with backups.",
      "secret": true
    },
    "GRIST_PORT": {
      "type": "integer",
      "description": "Grist Community published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11082
    },
    "GRIST_OWNER_EMAIL": {
      "type": "string",
      "description": "Local single-user document identity, not a password or verified login."
    },
    "GRIST_SESSION_SECRET": {
      "type": "string",
      "description": "Persistent random session signing secret; use at least 32 random characters.",
      "secret": true
    },
    "GROBID_PORT": {
      "type": "integer",
      "description": "GROBID published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11012
    },
    "GROCY_PORT": {
      "type": "integer",
      "description": "Grocy published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11132
    },
    "GROCY_TZ": {
      "type": "string",
      "description": "IANA timezone used by the grocery service."
    },
    "HEALTHCHECKS_PORT": {
      "type": "integer",
      "description": "Healthchecks published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11123
    },
    "HEALTHCHECKS_SECRET_KEY": {
      "type": "string",
      "description": "Stable random 64-hex session signing secret.",
      "secret": true
    },
    "HEALTHCHECKS_DB_PASSWORD": {
      "type": "string",
      "description": "Distinct 64-hex PostgreSQL password; retain for existing data.",
      "secret": true
    },
    "HEDGEDOC_PORT": {
      "type": "integer",
      "description": "HedgeDoc published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11043
    },
    "HEDGEDOC_DATABASE_PASSWORD": {
      "type": "string",
      "description": "Persistent password for the dedicated notes database.",
      "secret": true
    },
    "HEDGEDOC_SESSION_SECRET": {
      "type": "string",
      "description": "Persistent random session signing secret; use at least 32 random characters.",
      "secret": true
    },
    "HEDGEDOC_DOMAIN": {
      "type": "string",
      "description": "Browser hostname and port, without scheme. Update with the published port."
    },
    "HEDGEDOC_ALLOW_REGISTER": {
      "type": "string",
      "description": "Allow local email/password account registration; false keeps account creation in the upstream CLI."
    },
    "HOMEBOX_PORT": {
      "type": "integer",
      "description": "Homebox published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11089
    },
    "HOMEBOX_API_KEY_PEPPER": {
      "type": "string",
      "description": "Stable random secret of at least 32 bytes for API-key hashing; retain with backups.",
      "secret": true
    },
    "HOMEBOX_ALLOW_REGISTRATION": {
      "type": "string",
      "description": "Enable first-account registration; set false and restart after creating the owner account."
    },
    "HOMEPAGE_PORT": {
      "type": "integer",
      "description": "Homepage published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11038
    },
    "HOMEPAGE_AUTH_PASSWORD": {
      "type": "string",
      "description": "Password for the Homepage dashboard; not the ODS account password.",
      "secret": true
    },
    "HOMEPAGE_AUTH_SECRET": {
      "type": "string",
      "description": "Persistent random session signing secret, at least 32 characters. Rotation invalidates sessions.",
      "secret": true
    },
    "HOMEPAGE_EXTERNAL_URL": {
      "type": "string",
      "description": "Exact browser origin for password sign-in. Update when changing port or hostname."
    },
    "HOMEPAGE_ALLOWED_HOSTS": {
      "type": "string",
      "description": "Comma-separated Host headers without schemes. Include homepage:3000 for ODS readiness; do not use a wildcard."
    },
    "HOMEPAGE_VAR_ODS_URL": {
      "type": "string",
      "description": "Browser URL of this ODS installation for the initial Portal link."
    },
    "HOPPSCOTCH_PORT": {
      "type": "integer",
      "description": "Hoppscotch Community published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11090
    },
    "HOPPSCOTCH_DB_PASSWORD": {
      "type": "string",
      "description": "64 random hexadecimal characters for the dedicated PostgreSQL account.",
      "secret": true
    },
    "HOPPSCOTCH_ENCRYPTION_KEY": {
      "type": "string",
      "description": "Stable 32-hex data-encryption key; retain with database backups.",
      "secret": true
    },
    "HUGINN_PORT": {
      "type": "integer",
      "description": "Huginn published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11022
    },
    "HUGINN_DATABASE_PASSWORD": {
      "type": "string",
      "description": "Persistent password for the private Huginn PostgreSQL database.",
      "secret": true
    },
    "HUGINN_SECRET_TOKEN": {
      "type": "string",
      "description": "Persistent random Rails secret, at least 64 random characters.",
      "secret": true
    },
    "HUGINN_ADMIN_PASSWORD": {
      "type": "string",
      "description": "Strong initial owner password; does not reset an existing account.",
      "secret": true
    },
    "HUGINN_INVITATION_CODE": {
      "type": "string",
      "description": "Private invitation code needed for additional registrations.",
      "secret": true
    },
    "HUGINN_ADMIN_USER": {
      "type": "string",
      "description": "Initial owner username."
    },
    "HUGINN_DOMAIN": {
      "type": "string",
      "description": "Browser-facing hostname and port."
    },
    "HUGINN_TIMEZONE": {
      "type": "string",
      "description": "Application timezone name supported by Rails."
    },
    "INFLUXDB_PORT": {
      "type": "integer",
      "description": "InfluxDB OSS published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11135
    },
    "INFLUXDB_ADMIN_PASSWORD": {
      "type": "string",
      "description": "Initial ods administrator password: random 64 hexadecimal characters.",
      "secret": true
    },
    "INFLUXDB_ADMIN_TOKEN": {
      "type": "string",
      "description": "Distinct random 64-hex initial operator token. Keep private; create scoped project tokens separately.",
      "secret": true
    },
    "INVOICESHELF_PORT": {
      "type": "integer",
      "description": "InvoiceShelf published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11122
    },
    "INVOICESHELF_KEY": {
      "type": "string",
      "description": "Stable random 64-hex encryption key; preserve with backups and never replace casually.",
      "secret": true
    },
    "IT_TOOLS_PORT": {
      "type": "integer",
      "description": "IT-Tools published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11059
    },
    "JAEGER_PORT": {
      "type": "integer",
      "description": "Jaeger published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11102
    },
    "JAEGER_GRPC_PORT": {
      "type": "string",
      "description": "Loopback OTLP gRPC ingestion port."
    },
    "JAEGER_HTTP_PORT": {
      "type": "string",
      "description": "Loopback OTLP HTTP ingestion port."
    },
    "JSCAD_PORT": {
      "type": "integer",
      "description": "JSCAD published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11083
    },
    "JSONCRACK_PORT": {
      "type": "integer",
      "description": "JSON Crack published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11142
    },
    "KANBOARD_PORT": {
      "type": "integer",
      "description": "Kanboard published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11063
    },
    "KANBOARD_INITIAL_PASSWORD": {
      "type": "string",
      "description": "Initial admin password, 12–72 UTF-8 bytes. Existing passwords are not reset.",
      "secret": true
    },
    "KARAKEEP_PORT": {
      "type": "integer",
      "description": "Karakeep published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11019
    },
    "KARAKEEP_AUTH_SECRET": {
      "type": "string",
      "description": "Persistent random session-signing secret; use at least 36 random bytes.",
      "secret": true
    },
    "KARAKEEP_SEARCH_KEY": {
      "type": "string",
      "description": "Private search index key, at least 16 random characters; keep across restarts.",
      "secret": true
    },
    "KARAKEEP_URL": {
      "type": "string",
      "description": "Browser-facing URL; match the host port and any intentional reverse proxy."
    },
    "KARAKEEP_DISABLE_SIGNUPS": {
      "type": "string",
      "description": "Set true after creating the intended local accounts."
    },
    "KESTRA_PORT": {
      "type": "integer",
      "description": "Kestra published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11025
    },
    "KESTRA_DATABASE_PASSWORD": {
      "type": "string",
      "description": "Persistent private PostgreSQL password.",
      "secret": true
    },
    "KESTRA_ADMIN_EMAIL": {
      "type": "string",
      "description": "Administrator email address for initial Basic Auth setup."
    },
    "KESTRA_ADMIN_PASSWORD": {
      "type": "string",
      "description": "Administrator password, at least eight characters with uppercase and a number.",
      "secret": true
    },
    "KESTRA_MANAGEMENT_PASSWORD": {
      "type": "string",
      "description": "Separate random password for the internal management endpoints.",
      "secret": true
    },
    "KESTRA_URL": {
      "type": "string",
      "description": "Browser-facing URL; update when changing the host port."
    },
    "KEYCLOAK_PORT": {
      "type": "integer",
      "description": "Keycloak published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11141
    },
    "KEYCLOAK_DB_PASSWORD": {
      "type": "string",
      "description": "Stable random 64-hex PostgreSQL password.",
      "secret": true
    },
    "KEYCLOAK_BOOTSTRAP_PASSWORD": {
      "type": "string",
      "description": "Distinct random 64-hex initial temporary administrator password, not an existing-account reset.",
      "secret": true
    },
    "KIWIX_PORT": {
      "type": "integer",
      "description": "Kiwix published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11099
    },
    "KOMGA_PORT": {
      "type": "integer",
      "description": "Komga published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11049
    },
    "KROKI_PORT": {
      "type": "integer",
      "description": "Kroki published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11072
    },
    "LANGUAGETOOL_PORT": {
      "type": "integer",
      "description": "LanguageTool published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11086
    },
    "CREDS_KEY": {
      "type": "string",
      "description": "AES-128 encryption key for stored credentials (auto-generated by setup.sh)",
      "secret": true
    },
    "CREDS_IV": {
      "type": "string",
      "description": "AES initialization vector for credential encryption (auto-generated by setup.sh)",
      "secret": true
    },
    "LIBRETRANSLATE_PORT": {
      "type": "integer",
      "description": "LibreTranslate published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11008
    },
    "LIBRETRANSLATE_LANGUAGES": {
      "type": "string",
      "description": "Comma-separated Argos language codes to install."
    },
    "LIGHTRAG_PORT": {
      "type": "integer",
      "description": "LightRAG published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11032
    },
    "LIGHTRAG_API_KEY": {
      "type": "string",
      "description": "Private access key for the LightRAG UI/API.",
      "secret": true
    },
    "LIGHTRAG_EMBEDDING_DIM": {
      "type": "string",
      "description": "Exact embedding dimension from the active embedding service; changing it requires reindexing."
    },
    "LIGHTRAG_EMBEDDING_TOKEN_LIMIT": {
      "type": "string",
      "description": "Actual maximum input tokens supported by the active embedding model."
    },
    "LIGHTRAG_MAX_TOTAL_TOKENS": {
      "type": "string",
      "description": "Retrieval context budget below the selected chat model context, leaving room for instructions and output."
    },
    "LIMESURVEY_PORT": {
      "type": "integer",
      "description": "LimeSurvey published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11125
    },
    "LIMESURVEY_DB_PASSWORD": {
      "type": "string",
      "description": "64-hex database password; preserve for existing PostgreSQL data.",
      "secret": true
    },
    "LIMESURVEY_ADMIN_PASSWORD": {
      "type": "string",
      "description": "Distinct 64-hex initial administrator password; existing accounts are not reset.",
      "secret": true
    },
    "LIMESURVEY_ADMIN_EMAIL": {
      "type": "string",
      "description": "Actual owner email address for initial administrator account."
    },
    "LINKWARDEN_PORT": {
      "type": "integer",
      "description": "Linkwarden published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11023
    },
    "LINKWARDEN_DATABASE_PASSWORD": {
      "type": "string",
      "description": "Random URL-safe database password (letters and digits, at least 32 characters).",
      "secret": true
    },
    "LINKWARDEN_AUTH_SECRET": {
      "type": "string",
      "description": "Persistent random authentication secret.",
      "secret": true
    },
    "LINKWARDEN_SEARCH_KEY": {
      "type": "string",
      "description": "Private search index key, at least 16 random characters.",
      "secret": true
    },
    "LINKWARDEN_AUTH_URL": {
      "type": "string",
      "description": "Browser-facing authentication URL including /api/v1/auth; match any custom port."
    },
    "LINKWARDEN_DISABLE_REGISTRATION": {
      "type": "string",
      "description": "Set true after creating the intended owner accounts."
    },
    "LISTMONK_PORT": {
      "type": "integer",
      "description": "Listmonk published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11120
    },
    "LISTMONK_DB_PASSWORD": {
      "type": "string",
      "description": "64-hex PostgreSQL password; preserve for existing database.",
      "secret": true
    },
    "LISTMONK_ADMIN_PASSWORD": {
      "type": "string",
      "description": "Distinct 64-hex initial password for ods administrator; does not reset an existing account.",
      "secret": true
    },
    "LLDAP_PORT": {
      "type": "integer",
      "description": "LLDAP published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11066
    },
    "LLDAP_ADMIN_PASSWORD": {
      "type": "string",
      "description": "Initial admin password, at least 12 characters. Existing passwords are preserved.",
      "secret": true
    },
    "LLDAP_JWT_SECRET": {
      "type": "string",
      "description": "Persistent random session signing secret, at least 32 characters.",
      "secret": true
    },
    "LLDAP_KEY_SEED": {
      "type": "string",
      "description": "Persistent random password-protection key seed, at least 32 characters. Back up with database.",
      "secret": true
    },
    "LLDAP_BASE_DN": {
      "type": "string",
      "description": "Directory namespace, for example dc=yourorganization,dc=internal."
    },
    "LOCALRECALL_PORT": {
      "type": "integer",
      "description": "LocalRecall published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11024
    },
    "LOCALRECALL_API_KEY": {
      "type": "string",
      "description": "At least 24 random ASCII characters without spaces or commas. Browser username is ods; this key is the password and API Bearer token.",
      "secret": true
    },
    "M3E_CANVAS_PORT": {
      "type": "integer",
      "description": "M3E Canvas published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11074
    },
    "MAILPIT_PORT": {
      "type": "integer",
      "description": "Mailpit published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11052
    },
    "MAILPIT_UI_AUTH": {
      "type": "string",
      "description": "UI credentials in username:password format; separate multiple pairs with spaces. No whitespace inside a username/password.",
      "secret": true
    },
    "MAILPIT_SMTP_AUTH": {
      "type": "string",
      "description": "SMTP credentials in username:password format; use separate development-only credentials.",
      "secret": true
    },
    "MAILPIT_SMTP_PORT": {
      "type": "string",
      "description": "Loopback host port for SMTP capture, separate from the web UI port."
    },
    "MAPSHAPER_PORT": {
      "type": "integer",
      "description": "Mapshaper published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11080
    },
    "MARIMO_PORT": {
      "type": "integer",
      "description": "marimo published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11110
    },
    "MARIMO_TOKEN": {
      "type": "string",
      "description": "64-hex editor authentication token; holders can execute notebook code.",
      "secret": true
    },
    "MEILISEARCH_PORT": {
      "type": "integer",
      "description": "Meilisearch Community published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11013
    },
    "MEILISEARCH_MASTER_KEY": {
      "type": "string",
      "description": "Search API master key, at least 16 characters.",
      "secret": true
    },
    "MEMOS_PORT": {
      "type": "integer",
      "description": "Memos published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11018
    },
    "MERMAID_LIVE_EDITOR_PORT": {
      "type": "integer",
      "description": "Mermaid Live Editor published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11071
    },
    "METABASE_PORT": {
      "type": "integer",
      "description": "Metabase published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11033
    },
    "METABASE_DATABASE_PASSWORD": {
      "type": "string",
      "description": "Persistent password for the private application PostgreSQL database.",
      "secret": true
    },
    "METABASE_ENCRYPTION_KEY": {
      "type": "string",
      "description": "Persistent encryption key, at least 16 characters; generate 32 random bytes and retain with backups.",
      "secret": true
    },
    "METABASE_SITE_URL": {
      "type": "string",
      "description": "Browser-facing URL used for application links."
    },
    "MICROBIN_PORT": {
      "type": "integer",
      "description": "MicroBin published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11051
    },
    "MICROBIN_ACCESS_PASSWORD": {
      "type": "string",
      "description": "Password for site-wide HTTP Basic login, username ods.",
      "secret": true
    },
    "MICROBIN_ADMIN_PASSWORD": {
      "type": "string",
      "description": "Separate administrator password; replaces the upstream default.",
      "secret": true
    },
    "MINIPAINT_PORT": {
      "type": "integer",
      "description": "miniPaint published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11078
    },
    "MLFLOW_PORT": {
      "type": "integer",
      "description": "MLflow published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11004
    },
    "MOSQUITTO_PORT": {
      "type": "integer",
      "description": "Eclipse Mosquitto published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11087
    },
    "MOSQUITTO_PASSWORD": {
      "type": "string",
      "description": "Exactly 64 hexadecimal characters for the local ods MQTT account; retain this credential for configured clients.",
      "secret": true
    },
    "MUMBLE_PORT": {
      "type": "integer",
      "description": "Mumble Server published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11131
    },
    "MUMBLE_SERVER_PASSWORD": {
      "type": "string",
      "description": "Random 64-hex shared connection password.",
      "secret": true
    },
    "MUMBLE_SUPERUSER_PASSWORD": {
      "type": "string",
      "description": "Distinct random 64-hex SuperUser password, reapplied at startup.",
      "secret": true
    },
    "NATS_PORT": {
      "type": "integer",
      "description": "NATS published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11128
    },
    "NATS_PASSWORD": {
      "type": "string",
      "description": "Random 64-hex password for the local ods NATS user.",
      "secret": true
    },
    "NAVIDROME_PORT": {
      "type": "integer",
      "description": "Navidrome published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11048
    },
    "NEO4J_PORT": {
      "type": "integer",
      "description": "Neo4j Community published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11139
    },
    "NEO4J_PASSWORD": {
      "type": "string",
      "description": "Initial neo4j password: random 64 hexadecimal characters; not a reset for existing databases.",
      "secret": true
    },
    "NEO4J_BOLT_PORT": {
      "type": "string",
      "description": "Loopback host port used by native Bolt drivers and the browser."
    },
    "NIFI_PORT": {
      "type": "integer",
      "description": "Apache NiFi published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11146
    },
    "NIFI_ADMIN_PASSWORD": {
      "type": "string",
      "description": "Random 64-hex password for the ods single-user administrator.",
      "secret": true
    },
    "NIFI_SENSITIVE_PROPS_KEY": {
      "type": "string",
      "description": "Independent random 64-hex flow encryption key; retain unchanged with backups.",
      "secret": true
    },
    "NIFI_PUBLIC_URL": {
      "type": "string",
      "description": "Browser URL; update together with NIFI_PORT if changing the published port."
    },
    "NODE_RED_PORT": {
      "type": "integer",
      "description": "Node-RED published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11088
    },
    "NODE_RED_ADMIN_PASSWORD": {
      "type": "string",
      "description": "Editor and HTTP-flow password for user ods; 16 to 72 UTF-8 bytes.",
      "secret": true
    },
    "NODE_RED_CREDENTIAL_SECRET": {
      "type": "string",
      "description": "Stable 64-hex encryption key; retain with backups to decrypt flow credentials.",
      "secret": true
    },
    "OLLAMA_MODEL": {
      "type": "string",
      "description": "Default model to load on startup"
    },
    "OPENREFINE_PORT": {
      "type": "integer",
      "description": "OpenRefine published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11081
    },
    "OPENSPEEDTEST_PORT": {
      "type": "integer",
      "description": "OpenSpeedTest published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11127
    },
    "OPENWEBUI_PIPELINES_PORT": {
      "type": "integer",
      "description": "Open WebUI Pipelines published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11109
    },
    "OPENWEBUI_PIPELINES_API_KEY": {
      "type": "string",
      "description": "64-hex management/client API key replacing the upstream shared default.",
      "secret": true
    },
    "OPTUNA_DASHBOARD_PORT": {
      "type": "integer",
      "description": "Optuna Dashboard published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11034
    },
    "ORTHANC_PORT": {
      "type": "integer",
      "description": "Orthanc published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11143
    },
    "ORTHANC_PASSWORD": {
      "type": "string",
      "description": "Random 64-hex password for the orthanc web/API account.",
      "secret": true
    },
    "OWNCAST_PORT": {
      "type": "integer",
      "description": "Owncast published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11129
    },
    "OWNCAST_ADMIN_PASSWORD": {
      "type": "string",
      "description": "Random 64-hex administrator password enforced on each startup.",
      "secret": true
    },
    "OWNCAST_STREAM_KEY": {
      "type": "string",
      "description": "Distinct random 64-hex RTMP stream key enforced for this deployment.",
      "secret": true
    },
    "PAIRDROP_PORT": {
      "type": "integer",
      "description": "PairDrop published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11061
    },
    "PAPERLESS_GPT_PORT": {
      "type": "integer",
      "description": "Paperless GPT published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11015
    },
    "PAPERLESS_GPT_API_TOKEN": {
      "type": "string",
      "description": "API token from your Paperless-ngx account.",
      "secret": true
    },
    "PDFDING_PORT": {
      "type": "integer",
      "description": "PdfDing published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11058
    },
    "PDFDING_SECRET_KEY": {
      "type": "string",
      "description": "Persistent random Django signing secret, at least 32 characters.",
      "secret": true
    },
    "PENPOT_PORT": {
      "type": "integer",
      "description": "Penpot published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11026
    },
    "PENPOT_DATABASE_PASSWORD": {
      "type": "string",
      "description": "Random persistent password for the private PostgreSQL database.",
      "secret": true
    },
    "PENPOT_SECRET_KEY": {
      "type": "string",
      "description": "Persistent session/signing secret: generate 64 random bytes, URL-safe base64 encoded.",
      "secret": true
    },
    "PENPOT_PUBLIC_URI": {
      "type": "string",
      "description": "Browser-facing URL; update when changing the port or reverse proxy."
    },
    "PENPOT_FLAGS": {
      "type": "string",
      "description": "Local installation flags. Disable registration after creating accounts; see README before exposing remotely."
    },
    "PGVECTOR_PORT": {
      "type": "integer",
      "description": "pgvector published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11098
    },
    "PGVECTOR_ADMIN_PASSWORD": {
      "type": "string",
      "description": "64-hex bootstrap administrator password; existing databases require SQL password rotation.",
      "secret": true
    },
    "PGVECTOR_APP_PASSWORD": {
      "type": "string",
      "description": "Distinct 64-hex password for ods_app, used by projects and authenticated health checks.",
      "secret": true
    },
    "PIPER_VOICE": {
      "type": "string",
      "description": "Default voice model"
    },
    "POCKETBASE_PORT": {
      "type": "integer",
      "description": "PocketBase published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11068
    },
    "PRESENTON_PORT": {
      "type": "integer",
      "description": "Presenton published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11007
    },
    "PRESIDIO_PORT": {
      "type": "integer",
      "description": "Presidio published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11020
    },
    "PROMETHEUS_PORT": {
      "type": "integer",
      "description": "Prometheus published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11101
    },
    "PROMPTFOO_PORT": {
      "type": "integer",
      "description": "Promptfoo published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11003
    },
    "RABBITMQ_PORT": {
      "type": "integer",
      "description": "RabbitMQ published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11105
    },
    "RABBITMQ_ADMIN_PASSWORD": {
      "type": "string",
      "description": "64-hex initial ods_admin password; existing accounts are preserved.",
      "secret": true
    },
    "RABBITMQ_NODE_SECRET": {
      "type": "string",
      "description": "Distinct stable 64-hex Erlang node/CLI cookie, preserved with backups.",
      "secret": true
    },
    "RABBITMQ_AMQP_PORT": {
      "type": "string",
      "description": "Loopback AMQP client listener."
    },
    "RADICALE_PORT": {
      "type": "integer",
      "description": "Radicale published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11097
    },
    "RADICALE_PASSWORD": {
      "type": "string",
      "description": "64-hex password for DAV account ods; rotation requires updating configured clients.",
      "secret": true
    },
    "REACTIVE_RESUME_PORT": {
      "type": "integer",
      "description": "Reactive Resume published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11093
    },
    "REACTIVE_RESUME_DB_PASSWORD": {
      "type": "string",
      "description": "64 random hexadecimal characters for the dedicated PostgreSQL account.",
      "secret": true
    },
    "REACTIVE_RESUME_AUTH_SECRET": {
      "type": "string",
      "description": "Stable 64-hex authentication secret; retain with backups.",
      "secret": true
    },
    "REACTIVE_RESUME_DISABLE_SIGNUPS": {
      "type": "string",
      "description": "Set true after creating the intended accounts to close registration."
    },
    "REDOC_PORT": {
      "type": "integer",
      "description": "ReDoc published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11062
    },
    "REMBG_PORT": {
      "type": "integer",
      "description": "rembg published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11001
    },
    "REST_SERVER_PORT": {
      "type": "integer",
      "description": "Restic REST Server published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11144
    },
    "REST_SERVER_PASSWORD": {
      "type": "string",
      "description": "Random 64-hex password for the ods backup transport account; not the Restic encryption password.",
      "secret": true
    },
    "RSS_BRIDGE_PORT": {
      "type": "integer",
      "description": "RSS-Bridge published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11134
    },
    "RVC_API_KEY": {
      "type": "string",
      "description": "API key for RVC service authentication (optional; leave empty to disable auth)"
    },
    "SFTPGO_PORT": {
      "type": "integer",
      "description": "SFTPGo published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11113
    },
    "SFTPGO_SETUP_CODE": {
      "type": "string",
      "description": "64-hex installation code required by the native first-administrator setup wizard.",
      "secret": true
    },
    "SFTPGO_SFTP_PORT": {
      "type": "string",
      "description": "Loopback SFTP port for project clients."
    },
    "SHIORI_PORT": {
      "type": "integer",
      "description": "Shiori published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11055
    },
    "SHIORI_INITIAL_PASSWORD": {
      "type": "string",
      "description": "First-account password for username shiori: 12 to 72 UTF-8 bytes. Does not reset existing accounts.",
      "secret": true
    },
    "SHIORI_HTTP_SECRET_KEY": {
      "type": "string",
      "description": "Persistent random session signing secret, at least 32 random characters.",
      "secret": true
    },
    "SHLINK_PORT": {
      "type": "integer",
      "description": "Shlink published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11121
    },
    "SHLINK_DB_PASSWORD": {
      "type": "string",
      "description": "64-hex PostgreSQL password.",
      "secret": true
    },
    "SHLINK_API_KEY": {
      "type": "string",
      "description": "Distinct 64-hex initial management API key; use native API-key management for revocation.",
      "secret": true
    },
    "SILVERBULLET_PORT": {
      "type": "integer",
      "description": "SilverBullet published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11040
    },
    "SOLR_PORT": {
      "type": "integer",
      "description": "Apache Solr published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11145
    },
    "SOLR_ADMIN_PASSWORD": {
      "type": "string",
      "description": "Random 64-hex initial ods administrator password; retain or rotate using the native security API.",
      "secret": true
    },
    "SPEACHES_PORT": {
      "type": "integer",
      "description": "Speaches published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11014
    },
    "SQLPAGE_PORT": {
      "type": "integer",
      "description": "SQLPage published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11126
    },
    "SQUOOSH_PORT": {
      "type": "integer",
      "description": "Squoosh published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11092
    },
    "SVGEDIT_PORT": {
      "type": "integer",
      "description": "SVG-Edit published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11077
    },
    "SWAGGER_EDITOR_PORT": {
      "type": "integer",
      "description": "Swagger Editor published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11137
    },
    "SWAGGER_UI_PORT": {
      "type": "integer",
      "description": "Swagger UI published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11054
    },
    "SYNCTHING_PORT": {
      "type": "integer",
      "description": "Syncthing published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11095
    },
    "SYNCTHING_GUI_PASSWORD": {
      "type": "string",
      "description": "64-hex initial password for GUI user ods; existing configured credentials are preserved.",
      "secret": true
    },
    "SYNCTHING_SYNC_PORT": {
      "type": "string",
      "description": "Loopback TCP synchronization listener; remote peers need deliberately configured reachability."
    },
    "TEMPORAL_PORT": {
      "type": "integer",
      "description": "Temporal Local published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11111
    },
    "TEMPORAL_GRPC_PORT": {
      "type": "string",
      "description": "Loopback Temporal SDK/worker gRPC port."
    },
    "THREEUI_COMMUNITY_PORT": {
      "type": "integer",
      "description": "ThreeUI Community published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11075
    },
    "TIKA_PORT": {
      "type": "integer",
      "description": "Apache Tika published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11011
    },
    "TRACCAR_PORT": {
      "type": "integer",
      "description": "Traccar published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11118
    },
    "TRACCAR_DB_PASSWORD": {
      "type": "string",
      "description": "64-hex database password; existing PostgreSQL credentials require native rotation.",
      "secret": true
    },
    "TRACCAR_DEVICE_PORT": {
      "type": "string",
      "description": "Loopback OsmAnd protocol port; remote devices require explicit networking."
    },
    "TRILIUM_PORT": {
      "type": "integer",
      "description": "Trilium Notes published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11037
    },
    "TYPESENSE_PORT": {
      "type": "integer",
      "description": "Typesense published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11005
    },
    "TYPESENSE_API_KEY": {
      "type": "string",
      "description": "A long random API key for the Typesense server.",
      "secret": true
    },
    "UMAMI_PORT": {
      "type": "integer",
      "description": "Umami published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11056
    },
    "UMAMI_INITIAL_PASSWORD": {
      "type": "string",
      "description": "Initial admin password: 12 to 72 UTF-8 bytes. Replaces only the unchanged upstream default.",
      "secret": true
    },
    "UMAMI_DATABASE_PASSWORD": {
      "type": "string",
      "description": "Persistent password for the dedicated PostgreSQL database.",
      "secret": true
    },
    "UMAMI_APP_SECRET": {
      "type": "string",
      "description": "Persistent random authentication secret of at least 32 characters.",
      "secret": true
    },
    "UMAMI_TWO_FACTOR_KEY": {
      "type": "string",
      "description": "Persistent 64-character hexadecimal encryption key for two-factor authentication.",
      "secret": true
    },
    "UPTIME_KUMA_PORT": {
      "type": "integer",
      "description": "Uptime Kuma published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11027
    },
    "VALKEY_PORT": {
      "type": "integer",
      "description": "Valkey published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11091
    },
    "VALKEY_PASSWORD": {
      "type": "string",
      "description": "64 random hexadecimal characters for the ods client account.",
      "secret": true
    },
    "VAULTWARDEN_PORT": {
      "type": "integer",
      "description": "Vaultwarden published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11124
    },
    "VAULTWARDEN_ADMIN_TOKEN": {
      "type": "string",
      "description": "Random 64-hex administrator access token, separate from the vault master password.",
      "secret": true
    },
    "VERDACCIO_PORT": {
      "type": "integer",
      "description": "Verdaccio published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11115
    },
    "VERDACCIO_PASSWORD": {
      "type": "string",
      "description": "64-hex password for the managed ods account. Changing it and restarting rotates login credentials.",
      "secret": true
    },
    "VIKUNJA_PORT": {
      "type": "integer",
      "description": "Vikunja published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11031
    },
    "VIKUNJA_SERVICE_SECRET": {
      "type": "string",
      "description": "Persistent random signing secret; generate at least 32 random bytes.",
      "secret": true
    },
    "VIKUNJA_SERVICE_PUBLICURL": {
      "type": "string",
      "description": "Exact browser URL including port and trailing slash."
    },
    "VIKUNJA_SERVICE_ENABLEREGISTRATION": {
      "type": "string",
      "description": "Allow first account creation; set false after creating the required accounts."
    },
    "WAKAPI_PORT": {
      "type": "integer",
      "description": "Wakapi published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11050
    },
    "WAKAPI_PASSWORD_SALT": {
      "type": "string",
      "description": "Persistent random password pepper, at least 32 random characters. Back up and do not rotate casually.",
      "secret": true
    },
    "WAKAPI_ALLOW_SIGNUP": {
      "type": "string",
      "description": "Allow account creation during local setup; set false after creating desired accounts."
    },
    "WALLABAG_PORT": {
      "type": "integer",
      "description": "Wallabag published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11060
    },
    "WALLABAG_SECRET": {
      "type": "string",
      "description": "Persistent 64-character hexadecimal signing secret.",
      "secret": true
    },
    "WALLABAG_INITIAL_PASSWORD": {
      "type": "string",
      "description": "Initial ods administrator password, at least 12 characters; existing accounts are not reset.",
      "secret": true
    },
    "WALLABAG_INITIAL_EMAIL": {
      "type": "string",
      "description": "Email address for the initial ods administrator."
    },
    "WALLOS_PORT": {
      "type": "integer",
      "description": "Wallos published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11094
    },
    "WALLOS_TIMEZONE": {
      "type": "string",
      "description": "IANA timezone used by the native recurring-payment and notification scheduler."
    },
    "WEBLATE_PORT": {
      "type": "integer",
      "description": "Weblate published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11138
    },
    "WEBLATE_DB_PASSWORD": {
      "type": "string",
      "description": "Random 64-hex PostgreSQL password; keep stable across recreation.",
      "secret": true
    },
    "WEBLATE_ADMIN_PASSWORD": {
      "type": "string",
      "description": "Distinct random 64-hex admin password, reapplied by native startup.",
      "secret": true
    },
    "WEBLATE_ADMIN_EMAIL": {
      "type": "string",
      "description": "Actual owner email for the administrator account; SMTP is configured separately."
    },
    "WIKIJS_PORT": {
      "type": "integer",
      "description": "Wiki.js published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11107
    },
    "WIKIJS_DB_PASSWORD": {
      "type": "string",
      "description": "64-hex private database password; browser administrator is created in native setup.",
      "secret": true
    },
    "WIREMOCK_PORT": {
      "type": "integer",
      "description": "WireMock published host port",
      "minimum": 1,
      "maximum": 65535,
      "default": 11035
    }
  }
}