Download the gdcloud CLI bundle to your system from the user interface (UI).
To download the gdcloud CLI through the UI:
Ask IO to help configure OrganizationNetworkPolicy (ONP) to allow traffic from a specific CIDR outside the organization to the artifact registry. Use service "all" in the OrganizationNetworkPolicy configuration.
Sign in and access the Google Distributed Cloud air-gapped Welcome page.
Navigate to the Connect with CLI section.
Click Download CLI Bundle.
Download an archived version of the gdcloud CLI
To download a different version of the gdcloud CLI, complete the
following steps:
Ask IO to help configure OrganizationNetworkPolicy (ONP) to allow traffic from a specific CIDR outside the organization to the artifact registry. Use service "all" in the OrganizationNetworkPolicy configuration.
Go to the Google Distributed Cloud air-gapped Welcome page.
In the Connect with CLI section, click Download CLI Bundle.
Choose the supported version of interest.
Extract the gdcloud CLI bundle
Extract the contents of the downloaded gdcloud CLI bundle to any location on your file system.
To replace an existing installation, remove
the existing google-distributed-cloud-hosted-cli directory and extract the
archive to the same location.
[[["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."],[[["\u003cp\u003eThis page explains the process of downloading the gdcloud CLI, which is essential for using Google Distributed Cloud (GDC) air-gapped commands in a Linux environment.\u003c/p\u003e\n"],["\u003cp\u003eUsers can download the most recent gdcloud CLI version directly from the Google Distributed Cloud air-gapped UI through the "Connect with CLI" section, after setting up the appropriate OrganizationNetworkPolicy.\u003c/p\u003e\n"],["\u003cp\u003eIt's also possible to download older, archived versions of the gdcloud CLI by navigating to the "Connect with CLI" section on the Welcome page, and selecting a chosen version.\u003c/p\u003e\n"],["\u003cp\u003eThe downloaded gdcloud CLI bundle is a compressed file, which must be extracted via the \u003ccode\u003etar -xf gdcloud_cli.tar.gz\u003c/code\u003e command.\u003c/p\u003e\n"],["\u003cp\u003eWhen replacing an existing installation of the gdcloud CLI, you must first delete the old installation directory before extracting the new bundle to the same location.\u003c/p\u003e\n"]]],[],null,["# Download the gdcloud CLI\n\nThis page details how to download the gdcloud CLI. You have two options for this download:\n\n1. [Download the latest version](#download-the-latest).\n2. [Download an archived version](#download-an-archived-version-of-the).\n\nDownload the latest gdcloud CLI\n-------------------------------\n\n| **Important:** All gdcloud CLI commands in the Google Distributed Cloud (GDC) air-gapped documentation use gdcloud CLI and require a Linux environment.\n\nDownload the gdcloud CLI bundle to your system from the user interface (UI).\n\nTo download the gdcloud CLI through the UI:\n\n1. Ask IO to help [configure OrganizationNetworkPolicy (ONP)](/distributed-cloud/hosted/docs/latest/gdch/platform/pa-user/org-network-policy) to allow traffic from a specific CIDR outside the organization to the artifact registry. Use service \"all\" in the OrganizationNetworkPolicy configuration.\n2. Sign in and access the Google Distributed Cloud air-gapped **Welcome** page.\n3. Navigate to the **Connect with CLI** section.\n4. Click **Download CLI Bundle**.\n\nDownload an archived version of the gdcloud CLI\n-----------------------------------------------\n\nTo download a different version of the gdcloud CLI, complete the\nfollowing steps:\n\n1. Ask IO to help [configure OrganizationNetworkPolicy (ONP)](/distributed-cloud/hosted/docs/latest/gdch/platform/pa-user/org-network-policy) to allow traffic from a specific CIDR outside the organization to the artifact registry. Use service \"all\" in the OrganizationNetworkPolicy configuration.\n2. Go to the Google Distributed Cloud air-gapped **Welcome** page.\n3. In the **Connect with CLI** section, click **Download CLI Bundle**.\n4. Choose the supported version of interest.\n\nExtract the gdcloud CLI bundle\n------------------------------\n\nExtract the contents of the downloaded gdcloud CLI bundle to any location on your file system.\n\nTo replace an existing installation, remove\nthe existing `google-distributed-cloud-hosted-cli` directory and extract the\narchive to the same location.\n\nExtract the bundle: \n\n tar -xf gdcloud_cli.tar.gz"]]
