Stay organized with collections
Save and categorize content based on your preferences.
Properties are settings that govern the behavior of the
gdcloud CLI.
Use properties to define settings on an organization and/or a project context
such as the organization console URL and project used by the
gdcloud CLI for authentication, the information to use when working
with Object Storage service, or the option to turn off automatic
gdcloud CLI component update checks. For more details about
organization and project context, see
View and switch context. Properties
can also be used to define gdcloud CLI preferences like
accessibility configuration for gdcloud CLI commands.
Properties and flags
The gdcloud CLI supports command flags that have the same effect
as gdcloud CLI properties. Properties allow you to maintain the
same settings across command executions while flags affect command behavior on a
per-invocation basis. Note that flags override properties when both are set.
Configurations
A configuration is a
named set of gdcloud CLI properties. The gdcloud CLI
uses a configuration named default as the initial active configuration. The
default configuration is suitable for most use cases. However, you can also
create additional configurations and switch between them as required.
List properties
To list the properties in the active
configuration, run:
gdcloudconfiglist
Set properties
To set a property in the active configuration, run gdcloud config set. The
following example sets the project property, where PROJECT_ID is the unique
ID for your project.
gdcloudconfigsetprojectPROJECT_ID
To set properties that are not in the core properties section, you must
specify the section followed by a forward slash before the property name. The
following example sets the login_config_cert_path to
/tmp/root-web-tls-ca.cert.
[[["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\u003eProperties are settings that control the behavior of the gdcloud CLI, enabling you to define configurations for organization and project contexts, as well as preferences.\u003c/p\u003e\n"],["\u003cp\u003eWhile flags have the same effect as properties, they only impact a single command execution, whereas properties maintain settings across multiple command executions.\u003c/p\u003e\n"],["\u003cp\u003eConfigurations are named sets of properties, and the gdcloud CLI uses a \u003ccode\u003edefault\u003c/code\u003e configuration that is suitable for most situations, but users can also create and switch between custom configurations.\u003c/p\u003e\n"],["\u003cp\u003eYou can list properties in the active configuration using the \u003ccode\u003egdcloud config list\u003c/code\u003e command and set properties using the \u003ccode\u003egdcloud config set\u003c/code\u003e command.\u003c/p\u003e\n"],["\u003cp\u003eAll available properties can be found by running the command \u003ccode\u003egdcloud topic configurations\u003c/code\u003e and looking under the Available Properties section.\u003c/p\u003e\n"]]],[],null,["# Manage gdcloud CLI properties\n\nProperties are settings that govern the behavior of the\ngdcloud CLI.\n\nUse properties to define settings on an organization and/or a project context\nsuch as the organization console URL and project used by the\ngdcloud CLI for authentication, the information to use when working\nwith Object Storage service, or the option to turn off automatic\ngdcloud CLI component update checks. For more details about\norganization and project context, see\n[View and switch context](/distributed-cloud/hosted/docs/latest/appliance/resources/gdcloud-context). Properties\ncan also be used to define gdcloud CLI preferences like\naccessibility configuration for gdcloud CLI commands.\n\nProperties and flags\n--------------------\n\nThe gdcloud CLI supports command flags that have the same effect\nas gdcloud CLI properties. Properties allow you to maintain the\nsame settings across command executions while flags affect command behavior on a\nper-invocation basis. Note that flags override properties when both are set.\n\nConfigurations\n--------------\n\nA [configuration](/distributed-cloud/hosted/docs/latest/appliance/resources/gdcloud-manage-configurations) is a\nnamed set of gdcloud CLI properties. The gdcloud CLI\nuses a configuration named `default` as the initial active configuration. The\n`default` configuration is suitable for most use cases. However, you can also\ncreate additional configurations and switch between them as required.\n\nList properties\n---------------\n\nTo list the properties in the active\n[configuration](/distributed-cloud/hosted/docs/latest/appliance/resources/gdcloud-manage-configurations), run: \n\n gdcloud config list\n\nSet properties\n--------------\n\nTo set a property in the active configuration, run `gdcloud config set`. The\nfollowing example sets the `project` property, where `PROJECT_ID` is the unique\nID for your project. \n\n gdcloud config set project \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e\n\nTo set properties that are not in the `core` properties section, you must\nspecify the section followed by a forward slash before the property name. The\nfollowing example sets the `login_config_cert_path` to\n`/tmp/root-web-tls-ca.cert`. \n\n gdcloud config set auth/login_config_cert_path \u003cvar translate=\"no\"\u003e/tmp/root-web-tls-ca.cert\u003c/var\u003e\n\nAvailable properties\n--------------------\n\nThe list of all properties can be found by running `gdcloud topic configurations`\ncommand and looking for the Available Properties section."]]
