Skip to main content

CLI Flags

CLI flags take precedence over environment variables.

FlagEnvironment variableDefaultDescription
-configICAL_FILTER_PROXY_CONFIGconfig.yamlConfig file path.
-addressICAL_FILTER_PROXY_ADDRESS:8080Public calendar listener address.
-management-addressICAL_FILTER_PROXY_MANAGEMENT_ADDRESSemptyOptional management listener address for liveness, readiness, and metrics.
-debugICAL_FILTER_PROXY_DEBUGfalseEnable debug logging.
-jsonICAL_FILTER_PROXY_JSONfalseEmit logs as JSON.
-validateICAL_FILTER_PROXY_VALIDATEfalseValidate config and exit.
-metricsICAL_FILTER_PROXY_METRICSfalseEnable Prometheus metrics.
-metrics-calendar-labelsICAL_FILTER_PROXY_METRICS_CALENDAR_LABELSfalseEnable per-calendar metric labels.
-trusted-proxy-cidrICAL_FILTER_PROXY_TRUSTED_PROXY_CIDRSemptyTrusted reverse proxy CIDR for forwarded client addresses. The flag may be repeated; the environment variable is comma-separated.
-versionnonefalsePrint version and exit.

Boolean environment variables use Go boolean parsing.