Skip to content

Configuration (Environment Variables)

All runtime configuration is provided via environment variables. System-level variables share the common prefix AUTOCFT_.

System Variables

VariableRequiredDefaultDescription
AUTOCFT_CF_API_TOKENYes-Cloudflare API Token (Tunnel read/write).
AUTOCFT_CF_ACCOUNT_IDYes-Cloudflare Account ID.
AUTOCFT_CF_TUNNEL_IDYes-Target Cloudflare Tunnel UUID.
AUTOCFT_BASEDIRNo/app/autocftWorking directory (history file / PocketBase data).
AUTOCFT_CRONNo*/10 * * * * *Sync cron (seconds enabled). Default: every 10s.
AUTOCFT_ADMIN_EMAILNoadmin@example.comSet admin account email(prepare for PocketBase)
AUTOCFT_ADMIN_PASSWORDNoautocft@admin#123Set admin account password(prepare for PocketBase)

Default Origin Override Variables

Used as global fallbacks when a container does not specify the corresponding label.

VariableTypeDescription
AUTOCFT_ORIGIN_CONNECT_TIMEOUTint(ms)TCP connect timeout.
AUTOCFT_ORIGIN_DISABLE_CHUNKED_ENCODINGboolDisable chunked transfer encoding.
AUTOCFT_ORIGIN_HTTP2_ORIGINboolAttempt HTTP/2.
AUTOCFT_ORIGIN_HTTP_HEADERstringOverride Host header.
AUTOCFT_ORIGIN_KEEP_ALIVE_CONNECTIONSintMax idle connections.
AUTOCFT_ORIGIN_KEEP_ALIVE_TIMEint(s)Idle connection timeout.
AUTOCFT_ORIGIN_NO_HAPPY_EYEBALLSboolDisable Happy Eyeballs (IPv4/IPv6 race).
AUTOCFT_ORIGIN_NO_TLS_VERIFYboolSkip TLS verification.
AUTOCFT_ORIGIN_ORIGIN_SERVER_NAMEstringExpected certificate hostname.
AUTOCFT_ORIGIN_PROXY_TYPEstring"" or socks.
AUTOCFT_ORIGIN_TCP_KEEP_ALIVEint(s)TCP keepalive interval.
AUTOCFT_ORIGIN_TLS_TIMEOUTint(s)TLS handshake timeout.

Cron Expression

Uses robfig/cron (seconds field enabled) format: sec min hour day month dow.

Security Recommendations

  • Minimize API Token permissions (least privilege).
  • Mount docker.sock read-only where possible.
  • Monitor logs for unexpected changes.

Next

Container labels: /en/labels

Released under the MIT License.