Overview

To set up and run Meshery on Linux or macOS, you will need to install mesheryctl. mesheryctl is the command-line interface (CLI) for Meshery. It is used to install, manage, and operate one or more Meshery deployments. mesheryctl can be installed via bash, is also available directly, or through Homebrew or Scoop.

Brew

Prerequisites

You need to have Brew installed on your Linux or macOS system to perform these actions.

Install mesheryctl using Brew

To install mesheryctl using homebrew, execute the following commands.

 

 $ brew install mesheryctl
 

You’re ready to run Meshery. To do so, execute the following command.

 $ mesheryctl system start

If you are running Meshery on Docker, execute the following command.

 $ mesheryctl system start -p docker

Meshery server supports customizing authentication flow callback URL, which can be configured in the following way

 $ MESHERY_SERVER_CALLBACK_URL=https://custom-host mesheryctl system start

mesheryctl uses your current Kubernetes context, your KUBECONFIG environment variable (~/.kube/config by default). Confirm if this Kubernetes cluster you want Meshery to interact with by running the following command: kubectl config get-contexts.

If there are multiple contexts in your kubeconfig file, specify the one you want to use with the use-context subcommand: kubectl config use-context <context-to-use>.

Upgrade mesheryctl using Brew

To upgrade mesheryctl, execute the following command.

 

 $ brew upgrade mesheryctl
 
 

➜  ~ brew upgrade mesheryctl
==> Upgrading 1 outdated package:
meshery/tap/mesheryctl 0.3.2 -> 0.3.4
==> Upgrading meshery/tap/mesheryctl
==> Downloading https://github.com/meshery/meshery/releases/download/v0.3.4/mesheryctl_0.3.4_Darwin_x86_64.zip
==> Downloading from https://github-production-release-asset-2e65be.s3.amazonaws.com/157554479/17522b00-2af0-11ea-8aef-cbfe8
######################################################################## 100.0%
🍺  /usr/local/Cellar/mesheryctl/0.3.4: 5 files, 10.2MB, built in 4 seconds
Removing: /usr/local/Cellar/mesheryctl/0.3.2... (5 files, 10.2MB)
Removing: /Users/lee/Library/Caches/Homebrew/mesheryctl--0.3.2.zip... (3.9MB)
==> Checking for dependents of upgraded formulae...
==> No dependents found!

Bash

To install or upgrade mesheryctl using bash, execute anyone of the following commands.

Option 1: Only install mesheryctl binary

 

 

  $ curl -L https://meshery.io/install | DEPLOY_MESHERY=false bash -
 
 

 

 

  $ curl -L https://meshery.io/install | PLATFORM=docker bash -
 
 

 

 

  $ curl -L https://meshery.io/install | PLATFORM=kubernetes bash -
 
 

Install mesheryctl binary and include one or more adapters to be deployed

 

 

  $ curl -L https://meshery.io/install | ADAPTERS=consul PLATFORM=kubernetes bash -
 
 

 
mesheryctl system start
 

If you are running Meshery on Docker, execute the following command.

 
mesheryctl system start -p docker
 

Related Reading

Meshery CLI Guides

Guides to using Meshery’s various features and components.

• Authenticating Meshery via CLI
• Configuring Autocompletion for `mesheryctl`
• Mesheryctl system commands
• Running system checks using Meshery CLI
• Using Meshery CLI
• Upgrading Meshery CLI

Installation Options

• Bash - Install Meshery CLI on Linux or MacOS with Bash
• Brew - Install Meshery CLI on Linux or macOS with Homebrew