config-reference

Map Edgion configuration fields across Controller TOML, Gateway TOML, and EdgionGatewayConfig CRD.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/Pandaala/Edgion --skill config-reference
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: config-reference
Source: https://github.com/Pandaala/Edgion/tree/main/skills/02-features/02-config
Command: npx skills add https://github.com/Pandaala/Edgion --skill config-reference

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Edgion operators often need to quickly understand which YAML/TOML fields exist, what they do, what defaults apply, and when each configuration layer takes effect—without digging through source code or scattered docs.

Core Features & Use Cases

  • Controller TOML schema reference: Provides the complete field definitions for edgion-controller, including server/admin listen settings, logging, validation toggles, configuration sync sizing, conf_center (filesystem vs Kubernetes), federation client options, and admin authentication bootstrap (OIDC and local auth).
  • Gateway TOML schema reference: Documents edgion-gateway configuration fields for controller connectivity, logging, Pingora server behavior, business log outputs, global rate-limit tuning, gRPC mTLS client settings, and access-log sensitive redaction.
  • EdgionGatewayConfig CRD schema reference: Explains GatewayClass-scoped dynamic configuration, including timeouts, retries, real IP extraction, security protections, global plugins, CORS preflight behavior, reference-grant validation, and path normalization guarantees.
  • Operational decision support: Helps you choose the correct configuration layer first (Controller TOML vs Gateway TOML vs CRD) before looking up specific options.

Quick Start

Use the config-reference skill to look up the exact configuration fields you need for your specific change (Controller startup settings, Gateway logging and rate limiting, or GatewayClass-level CRD policies).

Frequently Asked Questions about config-reference

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
Where do I configure Edgion GatewayClass timeouts and real-IP extraction?

GatewayClass timeouts and real-IP extraction are configured in the EdgionGatewayConfig CRD, which manages cluster-wide dynamic policies including security protections and path normalization.

How do I bootstrap admin authentication for the Edgion controller?

Admin authentication bootstrap is configured in the Controller TOML schema, which defines OIDC and local auth settings alongside server listen options and federation client options.

What is the best way to tune Pingora server and business logs in Edgion?

Pingora server and business logs are tuned using the Gateway TOML schema, which also documents global rate-limit tuning, gRPC mTLS client settings, and access-log sensitive redaction.

How do I choose between Controller TOML, Gateway TOML, and the CRD for Edgion configuration?

Choosing the correct Edgion configuration layer depends on the scope: Controller TOML handles startup settings, Gateway TOML manages gateway-level behavior, and the CRD applies GatewayClass-scoped dynamic configuration.

Does Edgion support dynamic configuration changes without restarting the gateway?

Edgion supports dynamic configuration changes through the EdgionGatewayConfig CRD for GatewayClass-scoped policies, while Controller TOML and Gateway TOML changes typically require restarts.

Why is my Edgion path normalization policy not applying to incoming traffic?

Path normalization policies are applied via the EdgionGatewayConfig CRD; ensure the CRD is correctly scoped to the GatewayClass and that reference-grant validation passes without errors.