---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.6
alternate:
  - https://ydb.tech/docs/en/reference/ydb-sdk/install.md?version=main
  - https://ydb.tech/docs/ru/reference/ydb-sdk/install.md?version=main
sourcePath: ru/core/reference/ydb-sdk/install.md
---
> **Documentation Index:** Fetch the complete configuration index at https://ydb.tech/docs/ru/llms.txt


<!-- source: ru/reference/ydb-sdk/_includes/install.md -->
# Установка SDK

<!-- markdownlint-disable blanks-around-fences -->

Ниже приведены инструкции по быстрой установке SDK. На рабочей станции должны быть предварительно установлены и сконфигурированы инструменты по работе с выбранным языком программирования, а также пакетные менеджеры.

Описание порядка сборки из исходного кода размещено в репозиториях исходного кода на GitHub, ссылки на которые приведены на странице [YDB SDK - Обзор](https://ydb.tech/docs/ru/reference/ydb-sdk/index.md?version=main).

{% list tabs %}

- Go

  Выполните команду из командной строки:

  <!-- source: ru/reference/ydb-sdk/_includes/install/cmd_go.md -->
  ```bash
  go get -u github.com/ydb-platform/ydb-go-sdk/v3
  ```
  <!-- endsource: ru/reference/ydb-sdk/_includes/install/cmd_go.md -->

  Для успешной установки в вашем окружении должен быть установлен [Go](https://go.dev/doc/install) версии не ниже 1.17.

- Java

  Добавьте зависимости в Maven-проект, как описано в пункте ["Install the SDK"](https://github.com/ydb-platform/ydb-java-sdk#install-the-sdk) файла `readme.md` в репозитории исходного кода.

- Python

  Выполните команду из командной строки:

  <!-- source: ru/reference/ydb-sdk/_includes/install/cmd_python.md -->
  ```bash
  python3 -m pip install ydb
  ```
  <!-- endsource: ru/reference/ydb-sdk/_includes/install/cmd_python.md -->

  Если команда не выполнилась успешно, убедитесь, что в вашем окружении установлен [Python3](https://www.python.org/downloads/) версии 3.8 или более новой, со включенным  пакетным менеджером [pip](https://pypi.org/project/pip/).

- С#

  <!-- source: ru/reference/ydb-sdk/_includes/install/cmd_dotnet.md -->
  ```bash
  dotnet add package Ydb.Sdk
  ```
  <!-- endsource: ru/reference/ydb-sdk/_includes/install/cmd_dotnet.md -->

- JavaScript

  <!-- source: ru/reference/ydb-sdk/_includes/install/cmd_npm.md -->
  ```bash
  npm install @ydbjs/core @ydbjs/query
  ```
  <!-- endsource: ru/reference/ydb-sdk/_includes/install/cmd_npm.md -->

  Минимальная поддерживаемая версия [Node.js®](https://nodejs.org/en/download) не ниже 20.19.

- Rust

  <!-- source: ru/reference/ydb-sdk/_includes/install/cmd_rust.md -->
  ```bash
  cargo add ydb
  ```
  <!-- endsource: ru/reference/ydb-sdk/_includes/install/cmd_rust.md -->

- C++

  ## Пакеты Debian (Ubuntu 24.04)

  Готовые `.deb`-пакеты для Ubuntu 24.04 (Noble), amd64 прикреплены к каждому [релизу на GitHub](https://github.com/ydb-platform/ydb-cpp-sdk/releases). Скачайте и установите их локально:

  <!-- source: ru/reference/ydb-sdk/_includes/install/cmd_cpp_deb.md -->
  ``` bash
  # Замените <TAG> на тег релиза со страницы GitHub releases
  TAG=<TAG>
  BASE="https://github.com/ydb-platform/ydb-cpp-sdk/releases/download/${TAG}"

  wget "${BASE}/yandex-googleapis-api-common-protos-1.0.0-Linux.deb"
  wget "${BASE}/libydb-cpp-dev_${TAG#v}_amd64.deb"
  # Дополнительные плагины:
  wget "${BASE}/libydb-cpp-iam-dev_${TAG#v}_amd64.deb"
  wget "${BASE}/libydb-cpp-otel-metrics-dev_${TAG#v}_amd64.deb"
  wget "${BASE}/libydb-cpp-otel-tracing-dev_${TAG#v}_amd64.deb"

  sudo apt-get update
  sudo apt-get install -y \
      ./yandex-googleapis-api-common-protos-*.deb \
      ./libydb-cpp-dev_*.deb ./libydb-cpp-iam-dev_*.deb \
      ./libydb-cpp-otel-metrics-dev_*.deb ./libydb-cpp-otel-tracing-dev_*.deb
  ```
  <!-- endsource: ru/reference/ydb-sdk/_includes/install/cmd_cpp_deb.md -->

  Доступные пакеты:

  - `yandex-googleapis-api-common-protos` — обязательная зависимость protobuf;
  - `libydb-cpp-dev` — основной SDK: статическая библиотека, публичные заголовки и файлы CMake-пакета;
  - `libydb-cpp-iam-dev` — плагин IAM-аутентификации (опционально);
  - `libydb-cpp-otel-metrics-dev` — плагин метрик OpenTelemetry (опционально);
  - `libydb-cpp-otel-tracing-dev` — плагин трассировки OpenTelemetry (опционально; для заголовков и библиотек OTel требуется `libydb-cpp-otel-metrics-dev`).

  {% note info %}

  - Поддерживаемая платформа: Ubuntu 24.04 (Noble), amd64.
  - Пакеты собраны без apt-зависимостей; установите `yandex-googleapis-api-common-protos` вместе с основным пакетом SDK.
  - Для других платформ используйте инструкции по сборке из исходного кода ниже.

  {% endnote %}

  ## Использование SDK в CMake

  После установки пакетов подключите SDK в CMake-проекте:

  <!-- source: ru/reference/ydb-sdk/_includes/install/cmd_cpp_cmake.md -->
  ``` cmake
  find_package(ydb-cpp-sdk REQUIRED COMPONENTS Driver Table Topic)
  target_link_libraries(myapp PRIVATE YDB-CPP-SDK::Driver YDB-CPP-SDK::Table)
  ```
  <!-- endsource: ru/reference/ydb-sdk/_includes/install/cmd_cpp_cmake.md -->

  При конфигурации проекта передайте `-DCMAKE_PREFIX_PATH=/usr/share/yandex`, так как пакеты устанавливаются в префикс Yandex.

  ## Сборка из исходного кода

  Склонируйте репозиторий [ydb-cpp-sdk](https://github.com/ydb-platform/ydb-cpp-sdk) и выполните команду из командной строки:

  <!-- source: ru/reference/ydb-sdk/_includes/install/cmd_cpp_build.md -->
  ``` bash
  cmake --preset release-${compiler} -D YDB_SDK_INSTALL=On
  cmake --build --preset default
  cmake --install build --prefix ${ydb_install_dir}
  ```
  <!-- endsource: ru/reference/ydb-sdk/_includes/install/cmd_cpp_build.md -->

  - `compiler` — ваш компилятор (`clang` или `gcc`);
  - `ydb_install_dir` — путь, по которому вы хотите установить SDK.

  Перед выполнением команды убедитесь, что все зависимости установлены. Полный список зависимостей для сборки и инструкции см. в [README](https://github.com/ydb-platform/ydb-cpp-sdk/blob/main/README.md) репозитория.

- PHP

  <!-- source: ru/reference/ydb-sdk/_includes/install/cmd_php.md -->
  ```bash
  composer require ydb-platform/ydb-php-sdk
  ```
  <!-- endsource: ru/reference/ydb-sdk/_includes/install/cmd_php.md -->

{% endlist %}
<!-- endsource: ru/reference/ydb-sdk/_includes/install.md -->