Quick Start with Docker Extension

The Docker Extension for Meshery extends Docker Desktop’s position as the developer’s go-to Kubernetes environment with easy access to full the capabilities of Meshery’s collaborative cloud native management features.

Prerequisites

You need Docker Desktop version of 4.10 or higher for this.

Install the Docker Meshery Extension

Select one of the following three options to install the Docker Meshery Extension:

Install the Docker Meshery Extension
Remove Meshery as a Docker Extension

Using Docker Desktop

Navigate to the Extensions marketplace of Docker Desktop. Search for Meshery and click the Install button to install the extension.

Click Open when installation is done or click Meshery on the left under Extensions.

Click Login to open the Layer5 Cloud login page. Login or Sign up and you will be redirected back to Docker Desktop.

Finally, click Launch Meshery to load Meshery Dashboard on a browser window. It runs at http://localhost:9081/ by default.

You can also open http://localhost:9081/ directly on a browser on the local machine after installing the Docker extension and complete the Layer5 Cloud login process to achieve the same result.

Using Docker Hub

Another way to install the Meshery Docker Extension is from the Docker Hub. Navigate to the Meshery Docker Extension page and click Open in Docker Desktop to get started. Once installed, the rest of the process is same as above.

Using Docker CLI

Finally, you can also install the Meshery Docker Extension using the Docker CLI. Follow the commands in the clipboard below.

  
    
    
      docker extension install meshery/docker-extension-meshery 
    
    
    
      docker extension install meshery/docker-extension-meshery
      
      Successfully installed Meshery
      mesheryctl system dashboard

It runs as a set of one or more containers inside your Docker Desktop virtual machine.

Remove Meshery Docker Extension

You can remove the Docker Extension from Docker Desktop interface or from the CLI.

Removing from Docker Desktop

Navigate to Manage under Extensions, click the ellipsis button (three vertical dots) and select Uninstall.

Removing using Docker CLI

To remove the extension from the command line, use the docker extension rm command.


$ docker extension rm meshery/docker-extension-meshery

Additional Cleanup

There could be redisual Images and Networks to remove after removing/uninstalling the extension. Follow the steps below to do so.

Remove Meshery Images (if necessary)

Meshery pulls Docker images for deploying the extension and there could be additional Meshery/Layer5 images based on how it was configured. You can remove these images using the docker rmi command. Start by listing all the images and then running the command for each image you want to remove. For example:


$ docker rmi layer5/meshery:stable-latest

Remove Meshery Docker Networks (if necessary)

Meshery creates custom Docker networks, and they could still be left after the extension uninstall. These can be removed using the docker network rm command. For example:


$ docker network rm meshery_default

Recent Discussions with "meshery" Tag

Feb 19 | Error: HTTP Error Response: 404 Not Found (/api/provider/extension/provider/navigator/meshmap/index.js) by Lawrence Li
Feb 18 | Naming of Type of model relationship kind Edge by Lawrence Li
Feb 12 | Meshery Development Meeting | February 12th 2025 by Vivek Vishal
Feb 06 | Error while launching the Meshery Dashboard by Arpit Srivastava
Feb 05 | Meshery Development Meeting | February 5th 2025 by Vivek Vishal
Jan 29 | Meshery Development Meeting | January 29th 2025 by Vivek Vishal
Feb 04 | How to generate a model from the Meshery Integration sheet using local csv files? by Lawrence Li
Feb 02 | Hands-on Training Session: Migrating Components to MUI v5 and Sistent by Vivek Vishal
Jan 24 | Unable to set up meshery locally by ashish
Jan 25 | Unhandled Error after running mesheryctl system dashboard --port-forward by Sagnik Pal