This document shows how to download thegkeadmcommand-line tool that
you use to create an admin workstation for Google Distributed Cloud.
Typically,gkeadmis the only component that you have to download manually.
In some cases, you might want to manually downolad one or more of these other
components:
To see whether you are logged in, view your SDKaccountproperty:
gcloud config get-value account
To sign in:
gcloud auth login
Downloadgkeadm
You use thegkeadmcommand-line tool to create an admin workstation. Then you
get an SSH connection to your admin workstation, and from there, you create
clusters.
Thegkeadmcommand-line tool is available for 64-bit Linux.
gkeadmis also available for macOS 10.15 and higher, Windows 10, and Windows
Server 2019. However, support for macOS and Windows is deprecated and will be
removed in a future release.
ReplaceVERSIONwith the version of Google Distributed Cloud you
want to install or upgrade your clusters to. The latest available patch version
is 1.16.8-gke.19. For a list of available versions, seeVersion history.
Verifygkeadmusingopenssl
You can useopensslto verify thegkeadmbinary against the public key.
Copy the following public key to a file:
-----BEGIN PUBLIC KEY-----
MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEWZrGCUaJJr1H8a36sG4UUoXvlXvZ
wQfk16sxprI2gOJ2vFFggdq3ixF2h4qNBt0kI7ciDhgpwS8t+/960IsIgw==
-----END PUBLIC KEY-----
[[["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-09-04 UTC."],[[["\u003cp\u003e\u003ccode\u003egkeadm\u003c/code\u003e is a command-line tool used to create an admin workstation for Google Distributed Cloud, and it's typically the only component that requires manual download.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003egkeadm\u003c/code\u003e tool is available for 64-bit Linux, and while it's also available for macOS and Windows, support for these operating systems is deprecated and will be removed in a future release.\u003c/p\u003e\n"],["\u003cp\u003eTo download \u003ccode\u003egkeadm\u003c/code\u003e, use the \u003ccode\u003egcloud storage cp\u003c/code\u003e command, replacing \u003ccode\u003eVERSION\u003c/code\u003e with the desired Google Distributed Cloud version, and then use the \u003ccode\u003echmod +x gkeadm\u003c/code\u003e command to make the file executable if on Linux or macOS.\u003c/p\u003e\n"],["\u003cp\u003eYou can verify the integrity of the downloaded \u003ccode\u003egkeadm\u003c/code\u003e binary using \u003ccode\u003eopenssl\u003c/code\u003e against a provided public key to ensure it hasn't been tampered with, where the expected output should be \u003ccode\u003eVerified OK\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eYou need to be logged into a Google Account to view your account properties or to sign in using the \u003ccode\u003egcloud config get-value account\u003c/code\u003e or \u003ccode\u003egcloud auth login\u003c/code\u003e command respectively.\u003c/p\u003e\n"]]],[],null,["# Download gkeadm\n\n\u003cbr /\u003e\n\nThis document shows how to download the `gkeadm` command-line tool that\nyou use to create an admin workstation for Google Distributed Cloud.\n\nTypically, `gkeadm` is the only component that you have to download manually.\nIn some cases, you might want to manually downolad one or more of these other\ncomponents:\n\n- Admin workstation Open Virtual Appliance (OVA)\n- Google Distributed Cloud bundle\n- `gkectl` command-line tool\n\nFor more information, see [Downloads](/anthos/clusters/docs/on-prem/1.16/downloads).\n\nBefore you begin\n----------------\n\nYou must be logged in with a\n[Google Account](https://www.google.com/account/about/).\n\nTo see whether you are logged in, view your SDK `account`\n[property](/sdk/docs/properties):\n\n```\ngcloud config get-value account\n```\n\nTo sign in:\n\n```\ngcloud auth login\n```\n\nDownload `gkeadm`\n-----------------\n\nYou use the `gkeadm` command-line tool to create an admin workstation. Then you\nget an SSH connection to your admin workstation, and from there, you create\nclusters.\n\nThe `gkeadm` command-line tool is available for 64-bit Linux.\n\n`gkeadm` is also available for macOS 10.15 and higher, Windows 10, and Windows\nServer 2019. However, support for macOS and Windows is deprecated and will be\nremoved in a future release. \n\n### Linux\n\n```\ngcloud storage cp gs://gke-on-prem-release/gkeadm/VERSION/linux/gkeadm ./\nchmod +x gkeadm\n```\n\n### Windows\n\n```\ngcloud storage cp gs://gke-on-prem-release/gkeadm/VERSION/windows/gkeadm.exe ./\n```\n| **Note:** Support for Windows is deprecated and will be removed in a future release.\n\n### macOS Catalina\n\n```\ngcloud storage cp gs://gke-on-prem-release/gkeadm/VERSION/darwin/gkeadm ./\nchmod +x gkeadm\n```\n| **Note:** Support for macOS is deprecated and will be removed in a future release.\n\nReplace \u003cvar translate=\"no\"\u003eVERSION\u003c/var\u003e with the version of Google Distributed Cloud you\nwant to install or upgrade your clusters to. The latest available patch version\nis 1.16.8-gke.19. For a list of available versions, see\n[Version history](/anthos/clusters/docs/on-prem/1.16/version-history#supported-versions).\n\n### Verify `gkeadm` using `openssl`\n\nYou can use `openssl` to verify the `gkeadm` binary against the public key.\n\n```\ngcloud storage cp gs://gke-on-prem-release/gkeadm/VERSION/linux/gkeadm.1.sig /tmp/gkeadm.1.sig\necho \"-----BEGIN PUBLIC KEY-----\nMFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEWZrGCUaJJr1H8a36sG4UUoXvlXvZ\nwQfk16sxprI2gOJ2vFFggdq3ixF2h4qNBt0kI7ciDhgpwS8t+/960IsIgw==\n-----END PUBLIC KEY-----\" \u003e key.pem\nopenssl dgst -verify key.pem -signature /tmp/gkeadm.1.sig ./gkeadm\n```\n\nThe expected output of this command is `Verified OK`."]]
