Quick Start Guide

Getting Meshery up and running locally on a Docker-enabled system or in Kubernetes is easy. Meshery deploys as a set of Docker containers, which can be deployed to either a Docker host or Kubernetes cluster.

All Supported Platforms

Download, install, and run Meshery in a single command. See all supported platforms.

Install Meshery

To install and start Meshery, begin by installing mesheryctl. If you are on macOS or Linux system, you can download, install, and run both mesheryctl and Meshery Server with the command shown in the figure.

curl -L https://meshery.io/install | PLATFORM=kubernetes bash -
curl -L https://meshery.io/install | PLATFORM=kubernetes bash - Successfully installed Meshery mesheryctl system dashboard

Meshery CLI Package Managers

In addition to Bash, you can also use Brew or Scoop to install mesheryctl. Alternatively, mesheryctl is also available direct download.

Install using Docker Meshery Extension

You can find the Docker Meshery Extension in Docker Hub marketplace or use the Extensions browser in Docker Desktop to install the Docker Meshery Extension.

Docker Meshery Extension

Access Meshery

Your default browser will be opened and directed to Meshery’s web-based user interface typically found at http://localhost:9081.

Accessing Meshery UI

Meshery's web-based user interface is embedded in Meshery Server and is available as soon as Meshery starts. The location and port that Meshery UI is exposed varies depending upon your mode of deployment. See accessing Meshery UI for deployment-specific details.

Select a Provider

Select from the list of Providers in order to login to Meshery. Authenticate with your chosen Provider.

Configure Connections to your Kubernetes Clusters

If you have deployed Meshery out-of-cluster, Meshery will automatically connect to any available Kubernetes clusters found in your kubeconfig (under $HOME/.kube/config). If you have deployed Meshery out-of-cluster, Meshery will automatically connect to the Kubernetes API Server availabe in the control plane. Ensure that Meshery is connected to one or more of your Kubernetes clusters.

Visit Settings:

If your config has not been autodetected, you can manually upload your kubeconfig file (or any number of kubeconfig files). By default, Meshery will attempt to connect to and deploy Meshery Operator to each reachable context contained in the imported kubeconfig files. See Managing Kubernetes Clusters for more information.

Verify Deployment

Run connectivity tests and verify the health of your Meshery system. Verify Meshery’s connection to your Kubernetes clusters by clicking on the connection chip. A quick connectivity test will run and inform you of Meshery’s ability to reach and authenticate to your Kubernetes control plane(s). You will be notified of your connection status. You can also verify any other connection between Meshery and either its components (like Meshery Adapters) or other managed infrastructure by clicking on any of the connection chips. When clicked, a chip will perform an ad hoc connectivity test.

Design and operate Kubernetes clusters and their workloads

You may now proceed to managed any cloud native infrastructure supported by Meshery. See all integrations for a complete list of supported infrastructure.

Additional Guides