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

# Установка YDB DSTool

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

{% list tabs %}

- Linux

     <!-- source: ru/reference/ydb-dstool/_includes/unix_install.md -->
     Чтобы установить YDB DSTool:

     1. Выполните команду:

         <!-- source: ru/reference/ydb-dstool/_includes/unix_install_command.md -->
         <!-- markdownlint-disable blanks-around-fences -->

         ```bash
         curl -sSL 'https://install.ydb.tech/dstool' | bash
         ```

         Скрипт установит YDB DSTool. Если скрипт запускается из оболочки `bash` или `zsh`, он также добавит исполняемый файл `ydb-dstool` в переменную окружения `PATH`. В противном случае вы можете запускать его из папки `~/ydb/bin` или добавить в `PATH` вручную.
         <!-- endsource: ru/reference/ydb-dstool/_includes/unix_install_command.md -->

     1. Чтобы обновить переменные окружения, перезапустите командную оболочку.

     1. Проверьте работу, выполнив команду вывода информации о кластере:

         <!-- source: ru/reference/ydb-dstool/_includes/test.md -->
         <!-- markdownlint-disable blanks-around-fences -->

         ```bash
         ydb-dstool -e <bs_endpoint> cluster list
         ```

         * `bs_endpoint` — URI HTTP-эндпоинта кластера — это тот же самый эндпоинт, который обслуживает [Embedded UI](https://ydb.tech/docs/ru/reference/embedded-ui/index.md). Пример: `http://localhost:8765`.

         Результат:

         ```text
         ┌───────┬───────┬───────┬────────┬────────┬───────┬────────┐
         │ Hosts │ Nodes │ Pools │ Groups │ VDisks │ Boxes │ PDisks │
         ├───────┼───────┼───────┼────────┼────────┼───────┼────────┤
         │ 8     │ 16    │ 1     │ 5      │ 40     │ 1     │ 32     │
         └───────┴───────┴───────┴────────┴────────┴───────┴────────┘
         ```
         <!-- endsource: ru/reference/ydb-dstool/_includes/test.md -->
     <!-- endsource: ru/reference/ydb-dstool/_includes/unix_install.md -->

- macOS

    <!-- source: ru/reference/ydb-dstool/_includes/unix_install.md -->
    Чтобы установить YDB DSTool:

    1. Выполните команду:

        <!-- source: ru/reference/ydb-dstool/_includes/unix_install_command.md -->
        <!-- markdownlint-disable blanks-around-fences -->

        ```bash
        curl -sSL 'https://install.ydb.tech/dstool' | bash
        ```

        Скрипт установит YDB DSTool. Если скрипт запускается из оболочки `bash` или `zsh`, он также добавит исполняемый файл `ydb-dstool` в переменную окружения `PATH`. В противном случае вы можете запускать его из папки `~/ydb/bin` или добавить в `PATH` вручную.
        <!-- endsource: ru/reference/ydb-dstool/_includes/unix_install_command.md -->

    1. Чтобы обновить переменные окружения, перезапустите командную оболочку.

    1. Проверьте работу, выполнив команду вывода информации о кластере:

        <!-- source: ru/reference/ydb-dstool/_includes/test.md -->
        <!-- markdownlint-disable blanks-around-fences -->

        ```bash
        ydb-dstool -e <bs_endpoint> cluster list
        ```

        * `bs_endpoint` — URI HTTP-эндпоинта кластера — это тот же самый эндпоинт, который обслуживает [Embedded UI](https://ydb.tech/docs/ru/reference/embedded-ui/index.md). Пример: `http://localhost:8765`.

        Результат:

        ```text
        ┌───────┬───────┬───────┬────────┬────────┬───────┬────────┐
        │ Hosts │ Nodes │ Pools │ Groups │ VDisks │ Boxes │ PDisks │
        ├───────┼───────┼───────┼────────┼────────┼───────┼────────┤
        │ 8     │ 16    │ 1     │ 5      │ 40     │ 1     │ 32     │
        └───────┴───────┴───────┴────────┴────────┴───────┴────────┘
        ```
        <!-- endsource: ru/reference/ydb-dstool/_includes/test.md -->
    <!-- endsource: ru/reference/ydb-dstool/_includes/unix_install.md -->

- Windows

    Чтобы установить YDB DSTool:

    1. Выполните команду:

        - **PowerShell**:

            ```powershell
            iex (New-Object System.Net.WebClient).DownloadString('https://install.ydb.tech/dstool-windows')
            ```

        - **CMD**:

            ```cmd
            @"%SystemRoot%\System32\WindowsPowerShell\v1.0\powershell.exe" -Command "iex ((New-Object System.Net.WebClient).DownloadString('https://install.ydb.tech/dstool-windows'))"
            ```

    1. Укажите, нужно ли добавить путь к `ydb-dstool` в переменную окружения `PATH`:

        ```text
        Add ydb-dstool installation dir to your PATH? [Y/n]
        ```

    1. Чтобы обновить переменные окружения, перезапустите командную оболочку.

        {% note info %}

        YDB DSTool использует символы Юникода в выводе некоторых команд. При некорректном отображении таких символов в консоли Windows, переключите кодировку на UTF-8:

        ```cmd
        chcp 65001
        ```

        {% endnote %}

    1. Проверьте работу, выполнив команду вывода информации о кластере:

        <!-- source: ru/reference/ydb-dstool/_includes/test.md -->
        <!-- markdownlint-disable blanks-around-fences -->

        ```bash
        ydb-dstool -e <bs_endpoint> cluster list
        ```

        * `bs_endpoint` — URI HTTP-эндпоинта кластера — это тот же самый эндпоинт, который обслуживает [Embedded UI](https://ydb.tech/docs/ru/reference/embedded-ui/index.md). Пример: `http://localhost:8765`.

        Результат:

        ```text
        ┌───────┬───────┬───────┬────────┬────────┬───────┬────────┐
        │ Hosts │ Nodes │ Pools │ Groups │ VDisks │ Boxes │ PDisks │
        ├───────┼───────┼───────┼────────┼────────┼───────┼────────┤
        │ 8     │ 16    │ 1     │ 5      │ 40     │ 1     │ 32     │
        └───────┴───────┴───────┴────────┴────────┴───────┴────────┘
        ```
        <!-- endsource: ru/reference/ydb-dstool/_includes/test.md -->

{% endlist %}