# Vespa on Kubernetes

[](/en/operations/kubernetes/vespa-on-kubernetes.html.md "View as Markdown") 

Vespa applications can be deployed and managed on Kubernetes through the Vespa Operator. The Vespa Operator provides a native Kubernetes experience for managing Vespa infrastructure and applications:

- Declarative configuration through the [`VespaSet` Custom Resource](reference/vespaset-crd.html)
- Automated deployment, upgrades, and failure handling for Vespa infrastructure and applications
- Built-in integration with Kubernetes-native tooling for monitoring, log collection, and TLS

## Architecture
 ![Vespa Operator Architecture](/assets/img/vespa-operator-architecture.png)

The Vespa Operator is an implementation of the [Operator Pattern](https://kubernetes.io/docs/concepts/extend-kubernetes/operator/) that extends Kubernetes with custom orchestration capabilities for Vespa. It relies on a [Custom Resource Definition](https://kubernetes.io/docs/concepts/extend-kubernetes/api-extension/custom-resources/) called a `VespaSet`, which represents a quorum of [ConfigServers](https://docs.vespa.ai/en/operations/self-managed/configuration-server.html) in a Kubernetes namespace. The Vespa Operator is responsible for the deployment and lifecycle of the `VespaSet` resource and its ConfigServers, which collectively entails the infrastructure for Vespa on Kubernetes.

[Application Packages](https://docs.vespa.ai/en/basics/applications.html) are deployed to the [ConfigServers](https://docs.vespa.ai/en/operations/self-managed/configuration-server.html) to create Vespa applications. The ConfigServers will dynamically instantiate the services as individual Pods based on the settings provided in the Application Package. After an Application Package is deployed, the ConfigServers will remain responsible for the management and lifecycle of the Vespa application.

## Documentation

- [Operations](operations/index.html) — deploy and operate Vespa on Kubernetes: installation, permissions, lifecycle management, upgrades, and resource scaling. 
- [Configuration](configuration/index.html) — configure storage, logging, external access, custom overrides, TLS, and monitoring. 
- [Reference](reference/index.html) — reference documentation for the `VespaSet` CRD and the Helm chart. 

 Copyright © 2026 - [Cookie Preferences](#)

