Carvel kapp-controller
carvel.dev
- Free plan
- Linux
- Self-hosted
What Carvel kapp-controller is
Carvel kapp-controller provides declarative APIs for installing, managing and updating applications and packages on Kubernetes. Its App resource describes application installation, management and upgrades on a cluster; Package, PackageMetadata, PackageRepository and PackageInstall resources support authoring and consuming software packages. It can fetch configuration and OCI images from Git repositories, ConfigMaps, Helm charts and OCI registries, with customization through ytt, Helm templates and other tools. Carvel describes GitOps use in which a Git repository acts as the source of truth for package management. The kctrl CLI helps users inspect resources and helps package consumers get started. For fetched secret material, kapp-controller integrates with Mozilla SOPS, including GPG and age encryption support. Each App must specify a service account or kubeconfig Secret, and references must come from the same namespace. Packages and repositories can be relocated for air-gapped use. It is free open-source software under the Apache 2.0 license and is identified as a CNCF sandbox project. Versions at or below v0.36.1 cannot reconcile certain resources with Kubernetes v1.24’s default LegacyServiceAccountTokenNoAutoGeneration feature gate.
Who it suits
kapp-controller suits teams managing applications and packages on Kubernetes through declarative resources. Its namespace restrictions support multi-tenant environments, and packages can be relocated for air-gapped use.
Good to know, and what to watch
- Declarative installation, management and upgrades.
- Fetches configuration and images from several source types.
- Supports GitOps package management.
- SOPS integration supports GPG and age encryption.
- Packages can be relocated for air-gapped environments.
- Versions at or below v0.36.1 have a Kubernetes v1.24 limitation.
- App resources require an explicit service account or kubeconfig Secret.
Plans
Every plan and pricekapp-controller
Free plan
The verdict
kapp-controller brings application lifecycle and package management into Kubernetes custom resources, with GitOps, secret handling and air-gapped options. Check the compatibility note if using versions at or below v0.36.1 with Kubernetes v1.24.
What the maker publishes
- Air-gapped use
- Package repositories and packages can be relocated and run in air-gapped environments. source
- CLI
- The kctrl CLI helps users observe and interact with kapp-controller custom resources and helps package consumers get started faster. source
- Continuous delivery
- Its App custom resource supports declarative installation, management, and upgrades of applications on a Kubernetes cluster. source
- Fetch sources
- It can fetch configuration and OCI images from Git repositories, ConfigMaps, Helm charts, and OCI registries. source
- GitOps
- Carvel describes kapp-controller as supporting GitOps, including using a Git repository as the single source of truth for Kubernetes package management. source
- Integrations
- kapp-controller integrates with Mozilla SOPS to decrypt secret material in fetched configuration, with GPG and age encryption support. source
- Kubernetes compatibility
- The install guide says versions at or below v0.36.1 cannot reconcile App and PackageInstall resources with Kubernetes v1.24's default LegacyServiceAccountTokenNoAutoGeneration feature gate. source
- Multi-tenancy
- The security documentation says App resources can reference service accounts or kubeconfig Secrets only from the same namespace, supporting use in multi-tenant environments. source
- Package management
- Package, PackageMetadata, PackageRepository, and PackageInstall custom resources support authoring and consuming software packages. source
- Project status
- Carvel identifies kapp-controller as a Cloud Native Computing Foundation sandbox project. source
- Purpose
- kapp-controller provides declarative APIs to customize, install, and update Kubernetes applications and packages. source
- Security model
- Each App resource must specify a service account or kubeconfig Secret, making the privileges for managing app resources explicit. source
- Support
- Carvel provides community support through GitHub project issues and invites users to its Kubernetes Slack channel. source
- Templates
- It supports customizing software with ytt templates, Helm templates, and other tools. source
Checked against the maker's pages on 4 Oct 2026.