# Meshery — The Cloud-Native Manager

> Meshery is a CNCF-governed multi-mesh and multi-cluster management plane that designs, deploys, and operates Kubernetes infrastructure and service meshes through a visual catalog.

## Install

Save as a script file and run:

# Meshery — The Cloud-Native Manager

## Quick Use
```bash
# Install mesheryctl
curl -L https://meshery.io/install | PLATFORM=docker bash -

# Start Meshery connected to a K8s cluster
mesheryctl system start
mesheryctl system login

# Deploy a design (MeshPlan) from the catalog
mesheryctl pattern apply --file istio-bookinfo.yaml
```

## Introduction
Meshery acts as an opinionated control plane for the cloud-native stack. It treats each Kubernetes distribution, service mesh, and Helm chart as a first-class component that you compose visually and deploy declaratively across clusters.

## What Meshery Does
- Designs infrastructure visually via a drag-and-drop canvas (Kanvas)
- Installs and configures Istio, Linkerd, Consul, Cilium, Kuma, and more
- Benchmarks service mesh performance with a reproducible harness
- Validates configuration against CNCF best-practice policies
- Manages multi-cluster deployments from a single console

## Architecture Overview
Meshery Server (Go) fronts a pluggable adapter model where each mesh or component ships an adapter implementing a gRPC contract. State lives in PostgreSQL or an embedded BadgerDB. The React UI talks to the server via REST/GraphQL, and mesheryctl wraps the same APIs for CI use.

## Self-Hosting & Configuration
- `mesheryctl system start --platform docker` for local dev
- Helm chart `meshery/meshery` for Kubernetes installs
- Toggle adapters per mesh with `mesheryctl system config`
- Integrate SSO via OIDC or GitHub for team setups
- Persist designs in MeshPlans (YAML) checked into Git

## Key Features
- Unified catalog of 500+ cloud-native components
- Performance testing with fortio and wrk2 baked in
- Policy-as-code using OPA for design-time validation
- Designs export as kustomize or Helm for portability
- Supports both standalone and control-plane-free operation

## Comparison with Similar Tools
- **Rancher Fleet** — GitOps focused, less mesh-aware
- **Argo CD** — app delivery, not infra modeling
- **Crossplane** — composes cloud resources, different scope
- **KubeSphere** — broader platform, less mesh benchmarking
- **Istio Operator UI** — single mesh, no multi-cluster

## FAQ
**Q:** Is Meshery an alternative to Istio?
A: No — it manages Istio (and others). You still pick the mesh.

**Q:** Does it require internet?
A: For catalog sync; air-gapped installs can snapshot the catalog offline.

**Q:** Who governs it?
A: CNCF sandbox project, led by Layer5.

**Q:** Can I use Meshery for non-mesh components?
A: Yes — the component model covers any Kubernetes CRD or Helm chart.

## Sources
- https://github.com/meshery/meshery
- https://docs.meshery.io/

---
Source: https://tokrepo.com/en/workflows/84ca0b6a-38fa-11f1-9bc6-00163e2b0d79
Author: Script Depot