Stay organized with collections
Save and categorize content based on your preferences.
Downloading the troubleshooting tool
This page shows you how to download the troubleshooting tool for
Cloud Service Mesh. To debug and review your Cloud Service Mesh deployment
you need to install the istioctl component for Google Cloud CLI.
Download istioctl
Managed control plane
Update Google Cloud CLI:
gcloudcomponentsupdate
Download the embedded Cloud Service Mesh troubleshooting tool:
gcloudcomponentsinstallistioctl
If you receive error message You cannot perform this action because the
Google Cloud CLI component manager is disabled for this installation, you
have previously installed Google Cloud CLI through
Debian/Ubuntu. Use the
following commands instead:
Update Google Cloud CLI
sudoapt-getupdate
Download the embedded Cloud Service Mesh troubleshooting tool:
sudoapt-getinstallgoogle-cloud-sdk-istioctl
In-cluster control plane
Linux
Download the Cloud Service Mesh installation file to your current working directory:
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-25 UTC."],[],[],null,["# Downloading the troubleshooting tool\n====================================\n\nThis page shows you how to download the troubleshooting tool for\nCloud Service Mesh. To debug and review your Cloud Service Mesh deployment\nyou need to install the istioctl component for Google Cloud CLI.\n\nDownload istioctl\n-----------------\n\n### Managed control plane\n\n1. Update Google Cloud CLI:\n\n gcloud components update\n\n2. Download the embedded Cloud Service Mesh troubleshooting tool:\n\n gcloud components install istioctl\n\nIf you receive error message `You cannot perform this action because the\nGoogle Cloud CLI component manager is disabled for this installation`, you\nhave previously installed Google Cloud CLI through\n[Debian/Ubuntu](https://cloud.google.com/sdk/docs/install#deb). Use the\nfollowing commands instead:\n\n1. Update Google Cloud CLI\n\n sudo apt-get update\n\n2. Download the embedded Cloud Service Mesh troubleshooting tool:\n\n sudo apt-get install google-cloud-sdk-istioctl\n\n### In-cluster control plane\n\n### Linux\n\n1. Download the Cloud Service Mesh installation file to your current working directory:\n\n ```\n curl -LO https://storage.googleapis.com/gke-release/asm/istio-1.26.0-asm.11-linux-amd64.tar.gz\n ```\n2. Download the signature file and use `openssl` to verify the\n signature:\n\n ```\n curl -LO https://storage.googleapis.com/gke-release/asm/istio-1.26.0-asm.11-linux-amd64.tar.gz.1.sig\n openssl dgst -verify /dev/stdin -signature istio-1.26.0-asm.11-linux-amd64.tar.gz.1.sig istio-1.26.0-asm.11-linux-amd64.tar.gz \u003c\u003c'EOF'\n -----BEGIN PUBLIC KEY-----\n MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEWZrGCUaJJr1H8a36sG4UUoXvlXvZ\n wQfk16sxprI2gOJ2vFFggdq3ixF2h4qNBt0kI7ciDhgpwS8t+/960IsIgw==\n -----END PUBLIC KEY-----\n EOF\n ```\n\n The expected output is: `Verified OK`.\n3. Extract the contents of the file to any location on your file system. For\n example, to extract the contents to the current working directory:\n\n ```\n tar xzf istio-1.26.0-asm.11-linux-amd64.tar.gz\n ```\n\n The command creates an installation directory in your current working\n directory named `istio-1.26.0-asm.11` that contains: \n\n - Sample applications in the `samples` directory.\n - The `istioctl` command-line tool that you use to install Cloud Service Mesh is\n in the \u003ccode\u003ebin\u003c/code\u003e directory.\n - The Cloud Service Mesh configuration profiles are in the `manifests/profiles`\n directory.\n\n4. Ensure that you're in the Cloud Service Mesh installation's root directory.\n\n ```\n cd istio-1.26.0-asm.11\n ```\n\n### Mac OS\n\n1. Download the Cloud Service Mesh installation file to your current working\n directory:\n\n ```\n curl -LO https://storage.googleapis.com/gke-release/asm/istio-1.26.0-asm.11-osx.tar.gz\n ```\n2. Download the signature file and use `openssl` to verify the signature:\n\n ```\n curl -LO https://storage.googleapis.com/gke-release/asm/istio-1.26.0-asm.11-osx.tar.gz.1.sig\n openssl dgst -sha256 -verify /dev/stdin -signature istio-1.26.0-asm.11-osx.tar.gz.1.sig istio-1.26.0-asm.11-osx.tar.gz \u003c\u003c'EOF'\n -----BEGIN PUBLIC KEY-----\n MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEWZrGCUaJJr1H8a36sG4UUoXvlXvZ\n wQfk16sxprI2gOJ2vFFggdq3ixF2h4qNBt0kI7ciDhgpwS8t+/960IsIgw==\n -----END PUBLIC KEY-----\n EOF\n ```\n\n The expected output is: `Verified OK`.\n3. Extract the contents of the file to any location on your file system. For\n example, to extract the contents to the current working directory:\n\n ```\n tar xzf istio-1.26.0-asm.11-osx.tar.gz\n ```\n\n The command creates an installation directory in your current working\n directory named `istio-1.26.0-asm.11` that contains: \n\n - Sample applications in the `samples` directory.\n - The `istioctl` command-line tool that you use to install Cloud Service Mesh is\n in the \u003ccode\u003ebin\u003c/code\u003e directory.\n - The Cloud Service Mesh configuration profiles are in the `manifests/profiles`\n directory.\n\n4. Ensure that you're in the Cloud Service Mesh installation's root directory.\n\n ```\n cd istio-1.26.0-asm.11\n ```\n\n### Windows\n\n1. Download the Cloud Service Mesh installation file to your current working\n directory:\n\n ```\n curl -LO https://storage.googleapis.com/gke-release/asm/istio-1.26.0-asm.11-win.zip\n ```\n2. Download the signature file and use `openssl` to verify the signature:\n\n ```\n curl -LO https://storage.googleapis.com/gke-release/asm/istio-1.26.0-asm.11-win.zip.1.sig\n openssl dgst -verify - -signature istio-1.26.0-asm.11-win.zip.1.sig istio-1.26.0-asm.11-win.zip \u003c\u003c'EOF'\n -----BEGIN PUBLIC KEY-----\n MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEWZrGCUaJJr1H8a36sG4UUoXvlXvZ\n wQfk16sxprI2gOJ2vFFggdq3ixF2h4qNBt0kI7ciDhgpwS8t+/960IsIgw==\n -----END PUBLIC KEY-----\n EOF\n ```\n\n The expected output is: `Verified OK`.\n3. Extract the contents of the file to any location on your file system. For\n example, to extract the contents to the current working directory:\n\n ```\n tar xzf istio-1.26.0-asm.11-win.zip\n ```\n\n The command creates an installation directory in your current working\n directory named `istio-1.26.0-asm.11` that contains: \n\n - Sample applications in the `samples` directory.\n - The `istioctl` command-line tool that you use to install Cloud Service Mesh is\n in the \u003ccode\u003ebin\u003c/code\u003e directory.\n - The Cloud Service Mesh configuration profiles are in the `manifests/profiles`\n directory.\n\n4. Ensure that you're in the Cloud Service Mesh installation's root directory.\n\n ```\n cd istio-1.26.0-asm.11\n ```\n\nWhat's next\n-----------\n\n- [Troubleshoot Cloud Service Mesh step-by-step](/service-mesh/docs/troubleshooting/troubleshoot-intro)"]]
