-
kongctl
This page is an introduction to kongctl, Kong's command-line tool for managing Konnect resources and infrastructure as code.
-
Get started with kongctl
Learn how to use kongctl to manage Kong Konnect resources
kongctl Documentation
Install & Configure kongctl
-
Install kongctl on macOS
Use Homebrew to install kongctl
-
Install kongctl on Linux
Download and install the binary
-
Install kongctl on Windows
Install the Windows binary
-
Install kongctl with Mise
Use mise package manager
-
Configuration of kongctl
Learn how to configure kongctl using configuration files, environment variables, and command-line flags.
-
Authentication with kongctl
Learn how to authenticate kongctl to Kong Konnect using the device flow or personal access tokens.
Declarative Configuration
-
Declarative configuration with kongctl
Learn how to manage Kong Konnect infrastructure as code using declarative YAML configuration.
-
kongctl declarative resource reference
Reference for kongctl declarative configuration that lists supported resource types and their field-level values.
-
kongctl and decK
Learn how to use kongctl and decK together for declarative management of the entire API platform
Other References
-
Use kongctl with AI agent skills
Install kongctl agent skills to help coding agents manage kongctl configuration.
-
Listen to Konnect audit logs with kongctl
Learn how to use kongctl to listen to Konnect audit logs.
-
Troubleshooting kongctl
Common issues and solutions when using kongctl.
Adopt Resources
-
kongctl adopt
Adopt Kong resources using kongctl.
-
kongctl adopt analytics
The analytics command adopts Konnect Observability resources into namespace management.
-
kongctl adopt api
Adopt API resources.
-
kongctl adopt auth-strategy
Adopt authentication strategies.
-
kongctl adopt control-plane
Adopt control plane configurations.
-
kongctl adopt dcr-provider
Apply the KONGCTL-namespace label to an existing Konnect DCR provider that is not currently managed by kongctl.
-
kongctl adopt event-gateway
Apply the KONGCTL-namespace label to an existing Konnect Event Gateway Control Plane that is not currently managed by kongctl.
-
kongctl adopt konnect
Adopt Konnect resources.
-
kongctl adopt organization
Adopt organization settings.
-
kongctl adopt portal
Adopt Dev Portal configuration.
API Requests
-
kongctl api
Make API requests using kongctl.
-
kongctl api delete
Delete resources via API.
-
kongctl api get
Retrieve resources via API.
-
kongctl api patch
Partially update resources via API.
-
kongctl api post
Create resources via API.
-
kongctl api put
Update resources via API.
Apply Configuration
-
kongctl apply
Apply Konnect configuration using kongctl.
-
kongctl apply konnect
Apply configuration to Konnect control planes.
Delete Resources
-
kongctl delete
Delete resources using kongctl.
View Diffs
-
kongctl diff
Compare configurations using kongctl.
-
kongctl diff konnect
Show Konnect configuration differences.
Export Configuration
-
kongctl dump
Export configurations using kongctl.
-
kongctl dump declarative
Export declarative configuration.
-
kongctl dump tf-import
Export configurations into Terraform format.
Explain Schema
-
kongctl explain
Explain shows the declarative schema for a supported resource type or field path.
Get Resources
-
kongctl get
Get detailed information about resources using kongctl.
-
kongctl get analytics
The analytics command allows you to work with Konnect Observability resources.
-
kongctl get api
Get API details.
-
kongctl get audit-logs
Get audit logs.
-
kongctl get auth-strategy
Get authentication strategy details.
-
kongctl get catalog
Get API catalog details.
-
kongctl get dcr-provider
Use the get verb with the dcr-provider command to query Konnect Dynamic Client Registration providers.
-
kongctl get event-gateway
Use the get verb with the event-gateway command to query Konnect Event Gateways.
-
kongctl get extension
Get a kongctl CLI extension.
-
kongctl get gateway
Get gateway information.
-
kongctl get konnect
Get Konnect account information.
-
kongctl get me
Get current user information.
-
kongctl get organization
Get organization details.
-
kongctl get portal
Get Portal configuration.
-
kongctl get profile
Get user profiles.
-
kongctl get regions
Get available regions.
Install Assets
-
kongctl install
Install local assets that help coding agents work with Konnect using kongctl.
-
kongctl install extension
Install a kongctl CLI extension.
-
kongctl install skills
Install kongctl agent skills.
Link Features
-
kongctl link
Link locally developed features using kongctl.
-
kongctl link extension
Link a local development CLI extension.
Lint Files
-
kongctl lint
Validate configuration files against a linting ruleset.
List Resources
-
kongctl list
List resources using kongctl.
-
kongctl list api
List APIs.
-
kongctl list auth-strategy
List authentication strategies.
-
kongctl list dcr-provider
Use the list verb with the dcr-provider command to query Konnect Dynamic Client Registration providers.
-
kongctl list extensions
List installed kongctl CLI extensions.
-
kongctl list gateway
List gateways.
-
kongctl list konnect
List Konnect resources.
-
kongctl list organization
List organizations.
-
kongctl list portal
List Portal configurations.
-
kongctl list profile
The profile command allows you to list kongctl profiles and inspect profile configuration.
-
kongctl list themes
List Portal themes.
Listen to Events
-
kongctl listen
Listen to events using kongctl.
-
kongctl listen audit-logs
Listen to audit log stream.
-
kongctl listen konnect
Listen to Konnect events.
Login and Logout
-
kongctl login
Authenticate with kongctl.
-
kongctl login konnect
Log in to Konnect.
-
kongctl logout
Log out with kongctl.
-
kongctl logout konnect
Log out from Konnect.
Patch Files
-
kongctl patch
Patch resources using kongctl.
-
kongctl patch file
Apply patches from a declarative config file.
Plan Configuration Changes
-
kongctl plan
Plan changes using kongctl.
-
kongctl plan konnect
Plan changes for Konnect.
Manage Processes
-
kongctl ps
Manage processes using kongctl.
-
kongctl ps stop
Stop Kong processes.
Scaffold Configuration
-
kongctl scaffold
Scaffold emits a commented YAML starter configuration for a supported declarative resource path.
Sync Configuration
-
kongctl sync
Synchronize configurations using kongctl.
-
kongctl sync konnect
Sync configuration with Konnect control planes.
Tail Logs
-
kongctl tail
Tail logs using kongctl.
-
kongctl tail audit-logs
Tail audit logs.
-
kongctl tail konnect
Tail Konnect events.
Uninstall Features
-
kongctl uninstall
Uninstall kongctl features.
-
kongctl uninstall extension
Uninstall a kongctl CLI extension.
Upgrade Features
-
kongctl upgrade
Upgrade kongctl features.
-
kongctl upgrade extension
Upgrade kongctl CLI extensions.
Viewer
-
kongctl view
Launch the Konnect interactive viewer.