Yandex Cloud
Search
Contact UsTry it for free
  • Customer Stories
  • Documentation
  • Blog
  • All Services
  • System Status
  • Marketplace
    • Featured
    • Infrastructure & Network
    • Data Platform
    • AI for business
    • Security
    • DevOps tools
    • Serverless
    • Monitoring & Resources
  • All Solutions
    • By industry
    • By use case
    • Economics and Pricing
    • Security
    • Technical Support
    • Start testing with double trial credits
    • Cloud credits to scale your IT product
    • Gateway to Russia
    • Cloud for Startups
    • Center for Technologies and Society
    • Yandex Cloud Partner program
    • Price calculator
    • Pricing plans
  • Customer Stories
  • Documentation
  • Blog
© 2026 Direct Cursus Technology L.L.C.
Command line interface
  • Getting started with the CLI
    • Overview
      • Overview
      • get
      • list
      • set
      • unset
    • help
    • init
    • version
  • CLI releases
  • Troubleshooting
  1. CLI reference
  2. config
  3. Overview

yc config

Written by
Yandex Cloud
Updated at April 23, 2026

The 'yc config' command group lets you set, view and unset properties used by Yandex Cloud CLI.

Core propertiesCore properties

Property

Description

endpoint

string, Main Cloud API endpoint (host:port)

token

string, OAuth token 'yc' should use for authentication. Can be overridden by using the global '--token' flag.
Cannot be set at the same time as the 'service-account-key' and 'instance-service-account' properties. Setting one of them unsets the other.

service-account-key

object, IAM Key issued for service account that 'yc' should use for authentication.
Set from key file. See 'yc iam key create --help' for key create details.
Cannot be set at the same time as the 'token' and 'instance-service-account' property. Setting one of them unsets the other.

instance-service-account

bool, indicating that 'yc' should use for authentication Service Account of Compute Instance where 'yc' is executed.
See doc for yandex.cloud.compute.v1.CreateInstanceRequest.service_account_id for details.
Cannot be set at the same time as the 'token', 'service-account-key' properties. Setting one of them unsets the other.

organization-id

string, ID of the organization to operate on by default. Will be used, for example, in 'yc resource-manager cloud list' command.
Can be overridden by using the '--organization-id' flag.

cloud-id

string, ID of the cloud to operate on by default. Will be used, for example, in 'yc resource-manager folder list' command.
Can be overridden by using the global '--cloud-id' flag.

folder-id

ID of the folder to resolve names, list and create resources in by default. Can be overridden by using the global '--folder-id' flag.
Cannot be set at the same time as the 'folder-name' property. Setting one of them unsets the other.

folder-name

Name of the default folder to list and create resources in. Can be overridden by using the global '--folder-name' flag.
Cannot be set at the same time as the 'folder-id' property. Setting one of them unsets the other.

format

string, default output format: text, yaml, json. Can be overridden by using the global '--format' flag.

storage-endpoint

string, HTTP endpoint of storage service. By default cli takes endpoint from ApiEndpointService/Get handler

Yandex Compute Cloud propertiesYandex Compute Cloud properties

Property

Description

compute-default-zone

Default availability zone to create instances, disks, or subnets in.

Yandex S3 Storage propertiesYandex S3 Storage properties

Property

Description

s3.max-concurrent-requests

The maximum number of concurrent requests.

s3.max-queue-size

The maximum number of tasks in the task queue.

s3.multipart-chunksize

When using multipart transfers, this is the chunk size that the CLI uses for multipart transfers of individual files.

s3.multipart-threshold

The size threshold the CLI uses for multipart transfers of individual files.

Command UsageCommand Usage

Syntax:

yc config <group|command>

Command TreeCommand Tree

  • yc config get — Get value for the specified configuration property

  • yc config list — List configuration values

  • yc config set — Set value for the specified configuration property

  • yc config unset — Unset value for the specified configuration property

  • yc config profile — Manage configuration profiles

    • yc config profile activate — Activate the specified configuration profile

    • yc config profile create — Create a configuration profile

    • yc config profile delete — Delete the specified configuration profile

    • yc config profile get — List values for the specified configuration profile

    • yc config profile list — List configuration profiles

  • yc config v0 — Manage Yandex Cloud CLI configuration

    • yc config v0 get — Get value for the specified configuration property

    • yc config v0 list — List configuration values

    • yc config v0 set — Set value for the specified configuration property

    • yc config v0 unset — Unset value for the specified configuration property

Global FlagsGlobal Flags

Flag

Description

--profile

string

Set the custom configuration file.

--debug

Debug logging.

--debug-grpc

Debug gRPC logging. Very verbose, used for debugging connection problems.

--no-user-output

Disable printing user intended output to stderr.

--retry

int

Enable gRPC retries. By default, retries are enabled with maximum 5 attempts.
Pass 0 to disable retries. Pass any negative value for infinite retries.
Even infinite retries are capped with 2 minutes timeout.

--syntax

string

CLI syntax: 1 (legacy) or 2 (current). Omit to use default-syntax in the profile or the product default.

--cloud-id

string

Set the ID of the cloud to use.

--folder-id

string

Set the ID of the folder to use.

--folder-name

string

Set the name of the folder to use (will be resolved to id).

--endpoint

string

Set the Cloud API endpoint (host:port).

--token

string

Set the OAuth token to use.

--impersonate-service-account-id

string

Set the ID of the service account to impersonate.

--no-browser

Disable opening browser for authentication.

--format

string

Set the output format: text (default), yaml, json, json-rest.

--jq

string

Query to select values from the response using jq syntax

-h, --help

Display help for the command.

Was the article helpful?

Previous
list
Next
get
© 2026 Direct Cursus Technology L.L.C.