Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

Carvel kapp-controller

carvel.dev

  • Free plan
  • Linux
  • Self-hosted
7.0 Club score Visit carvel.dev

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.

kapp-controller

Free

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.