Skip to content

Configuration

This section covers all configuration options for the Cloudflare Tunnel Gateway Controller.

Overview

The controller can be configured at multiple levels:

  1. Controller Options - CLI flags and environment variables
  2. Helm Values - Deployment configuration via Helm chart
  3. GatewayClassConfig - Tunnel credentials and cloudflared settings

Sections

  • Controller Options

    CLI flags, environment variables, and runtime configuration.

    Controller Options

  • Helm Values

    Complete reference for Helm chart configuration values.

    Helm Values

  • GatewayClassConfig

    Custom Resource for tunnel credentials and cloudflared configuration.

    GatewayClassConfig

Configuration Flow

flowchart LR
    subgraph Kubernetes
        GCC[GatewayClassConfig]
        SEC[Secrets]
    end

    subgraph Controller
        RES[ConfigResolver]
        CONFIG[ResolvedConfig]
        CTRL[Controllers]
    end

    GCC --> RES
    SEC --> RES
    RES --> CONFIG
    CONFIG --> CTRL

Quick Reference

Configuration Source Purpose
--controller-name CLI flag GatewayClass controller name
--manage-cloudflared CLI flag Enable cloudflared deployment
tunnelID GatewayClassConfig Cloudflare Tunnel UUID
cloudflareCredentialsSecretRef GatewayClassConfig API token secret reference
tunnelTokenSecretRef GatewayClassConfig Tunnel token for cloudflared