<h1>Quick Start with Kubernetes </h1>

Manage your Kubernetes clusters with Meshery. Deploy Meshery in Kubernetes in-cluster or outside of Kubernetes out-of-cluster. Note: It is advisable to install Meshery in your Kubernetes clusters

<div class="prereqs"><h4>Prerequisites</h4> <ol> <li>Install the Meshery command line client, <a href="/installation/mesheryctl" class="meshery-light">mesheryctl</a>.</li> <li>Install <a href="https://kubernetes.io/docs/tasks/tools/">kubectl</a> on your local machine.</li> <li>Access to an active Kubernetes cluster.</li> </ol> </div>

Available Deployment Methods

• In-cluster Installation
  • Preflight Checks
    • Preflight: Cluster Connectivity
  • Installation: Using mesheryctl
  • Installation: Using Helm
  • Post-Installation Steps
• Out-of-cluster Installation
  • Set up Ingress on Minikube with the NGINX Ingress Controller
  • Installing cert-manager with kubectl

In-cluster Installation

Follow the steps below to install Meshery in your Kubernetes cluster.

Preflight Checks

Read through the following considerations prior to deploying Meshery on Kubernetes.

Preflight: Cluster Connectivity

Verify your kubeconfig's current context is set to the Kubernetes cluster you want to deploy Meshery to.

{{< code code="kubectl config current-context" >}}

Installation: Using mesheryctl

Once configured, execute the following command to start Meshery.

Before executing the below command, go to ~/.meshery/config.yaml and ensure that the current platform is set to Kubernetes.

{{< code code="mesheryctl system start" >}}

Installation: Using Helm

For detailed instructions on installing Meshery using Helm V3, please refer to the Helm Installation guide.

Post-Installation Steps

Optionally, you can verify the health of your Meshery deployment using <a href='/reference/mesheryctl/system/check'>mesheryctl system check</a>.

You're ready to use Meshery! Open your browser and navigate to the Meshery UI.

{{< installation/accessing-meshery-ui >}}

Out-of-cluster Installation

Install Meshery on Docker (out-of-cluster) and connect it to your Kubernetes cluster.

<!-- ## Installation: Upload Config File in Meshery Web UI - Run the below command to generate the _"config_minikube.yaml"_ file for your cluster: <pre class="codeblock-pre"><div class="codeblock"> <div class="clipboardjs">kubectl config view --minify --flatten > config_minikube.yaml</div></div> </pre> - Upload the generated config file by navigating to _Settings > Environment > Out of Cluster Deployment_ in the Web UI and using the _"Upload kubeconfig"_ option. -->

Set up Ingress on Minikube with the NGINX Ingress Controller

• Run the below command to enable the NGINX Ingress controller for your cluster:

{{< code code="minikube addons enable ingress" >}}

• To check if NGINX Ingress controller is running

{{< code code="kubectl get pods -n ingress-nginx" >}}

Installing cert-manager with kubectl

• Run the below command to install cert-manager for your cluster:

{{< code code="kubectl apply -f https://github.com/cert-manager/cert-manager/releases/download/v1.15.3/cert-manager.yaml" >}}

{{< related-discussions tag="meshery" >}}

See Also