# A web-based UI for deploying and managing applications in Kubernetes clusters


## Overview

Kubeapps is an in-cluster web-based application that enables users with a one-time installation to deploy, manage, and upgrade applications on a Kubernetes cluster.

With Kubeapps you can:

* Browse and deploy different packages like [Helm](https://github.com/helm/helm) charts, [Flux](https://fluxcd.io/) or [Carvel](https://carvel.dev/) packages from public or private repositories (including [VMware Marketplace™](https://marketplace.cloud.vmware.com/) and [Bitnami Application Catalog](https://bitnami.com/application-catalog))
    
* Customize deployments through an intuitive user interface
    
* Browse, upgrade and delete applications installed in the cluster
    
* Browse and deploy [Kubernetes Operators](https://operatorhub.io/)
    
* Secure authentication to Kubeapps using a [standalone OAuth2/OIDC provider](https://github.com/vmware-tanzu/kubeapps/blob/main/site/content/docs/latest/tutorials/using-an-OIDC-provider.md) or [using Pinniped](https://github.com/vmware-tanzu/kubeapps/blob/main/site/content/docs/latest/howto/OIDC/using-an-OIDC-provider-with-pinniped.md)
    
* Secure authorization based on Kubernetes [Role-Based Access Control](https://github.com/vmware-tanzu/kubeapps/blob/main/site/content/docs/latest/howto/access-control.md)
    

***Note:*** Kubeapps 2.0 and onwards supports Helm 3 only. While only the Helm 3 API is supported, in most cases, charts made for Helm 2 will still work.

## Getting started with Kubeapps

Installing Kubeapps is as simple as:

```yaml
helm repo add bitnami https://charts.bitnami.com/bitnami
kubectl create namespace kubeapps
helm install kubeapps --namespace kubeapps bitnami/kubeapps
```

See the [Getting Started Guide](https://github.com/vmware-tanzu/kubeapps/blob/main/site/content/docs/latest/tutorials/getting-started.md) for detailed instructions on how to install and use Kubeapps.

> Kubeapps is deployed using the official [Bitnami Kubeapps chart](https://github.com/bitnami/charts/tree/main/bitnami/kubeapps) from the separate Bitnami charts repository. Although the Kubeapps repository also defines a chart, this is intended for development purposes only.

## Documentation

Complete documentation available in Kubeapps [documentation section](https://github.com/vmware-tanzu/kubeapps/blob/main/site/content/docs/latest/README.md). Including complete tutorials, how-to guides, and reference for configuration and development in Kubeapps.

For getting started into Kubeapps, please refer to:

* [Getting started guide](https://github.com/vmware-tanzu/kubeapps/blob/main/site/content/docs/latest/tutorials/getting-started.md)
    
* [Detailed installation instructions](https://github.com/vmware-tanzu/kubeapps/blob/main/chart/kubeapps/README.md)
    
* [Kubeapps user guide](https://github.com/vmware-tanzu/kubeapps/blob/main/site/content/docs/latest/howto/dashboard.md) to easily manage your applications running in your cluster.
    
* [Kubeapps FAQs](https://github.com/vmware-tanzu/kubeapps/blob/main/chart/kubeapps/README.md#faq).
    

See how to deploy and configure [Kubeapps on VMware Tanzu™ Kubernetes Grid™](https://github.com/vmware-tanzu/kubeapps/blob/main/site/content/docs/latest/tutorials/kubeapps-on-tkg/README.md)

## Troubleshooting

If you encounter issues, please review the [troubleshooting docs](https://github.com/vmware-tanzu/kubeapps/blob/main/chart/kubeapps/README.md#troubleshooting), review our [project board](https://github.com/orgs/vmware-tanzu/projects/38/views/2), file an [issue](https://github.com/vmware-tanzu/kubeapps/issues), or talk to Kubeapps maintainers on the [#Kubeapps channel](https://kubernetes.slack.com/messages/kubeapps) on the Kubernetes Slack server.

* [Sign up](https://slack.k8s.io/) to the Kubernetes Slack org.
    
* Review the FAQs section on the [Kubeapps chart README](https://github.com/vmware-tanzu/kubeapps/blob/main/chart/kubeapps/README.md#faq).
    

## Contributing

If you are ready to jump in and test, add code, or help with documentation, follow the instructions on the [start contributing](https://github.com/vmware-tanzu/kubeapps/blob/main/CONTRIBUTING.md) documentation for guidance on how to setup Kubeapps for development.

## Changelog

Take a look at the list of [releases](https://github.com/vmware-tanzu/kubeapps/releases) to stay tuned for the latest features and changes.