patch.moi/docs/pages/reference/environment.md
2026-05-16 03:20:02 +00:00

1.3 KiB

title description
Environment Runtime environment variables used by patch.moi.

Environment

Variable Default Purpose
HOST 0.0.0.0 Server bind host.
PORT 3000 Server port.
DATA_DIR ./data Directory for JSONL state files.
FEED_SOURCES_PATH unset Enables feed polling from the configured JSON file.
PATCH_ADMIN_TOKEN unset Protects admin flow endpoints when set.
PATCH_FLOW_DISPATCH_URL unset Default flow backend URL for dispatch targets.
PATCH_FLOW_BACKEND_URL unset Alternate default backend base URL.
PATCH_FLOW_DISPATCH_SECRET unset HMAC secret for HTTP flow dispatch.
CODEX_APP_SERVER_CODEX_COMMAND unset Passed to local code-mode flow execution.
CODEX_HOME unset Passed to local code-mode flow execution.

Feed target fields can override backend settings with dispatchUrl, dispatchUrlEnv, and dispatchSecretEnv.

Git topology is intentionally not represented here. Local mode should read upstream, fork, branch, and tag state from Git. Service mode should read remote repository, branch, workflow, and review state from the forge. Environment variables should stay limited to runtime concerns such as dispatch URLs, data directories, and Codex execution settings.