> ## Documentation Index
> Fetch the complete documentation index at: https://dify-6c0370d8-release-1-15-0.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# difyctl のインストール

> ワンライナースクリプトまたは手動でのバイナリダウンロードによる difyctl のインストール

> このドキュメントは AI によって自動翻訳されています。不正確な部分がある場合は、[英語版](/en/cli/install) を参照してください。

`difyctl` はランタイム依存のない単体のバイナリです。インストールスクリプトがお使いのプラットフォームを検出し、Dify の GitHub Releases から対応するビルドをダウンロードして、チェックサムを検証し、バイナリを配置します。

<Note>
  `difyctl` には Dify 1.15.0 以降が必要です。
</Note>

## インストール

<Steps>
  <Step title="インストーラーの実行">
    `difyctl` のビルドは Dify の各リリースに同梱され、インストーラーはデフォルトで最新版を取得します。

    <Tabs>
      <Tab title="macOS / Linux">
        サポートするプラットフォーム：macOS と Linux、x64 と arm64。

        ```bash theme={null}
        curl -fsSL https://raw.githubusercontent.com/langgenius/dify/main/cli/scripts/install-cli.sh | sh
        ```

        スクリプトは `~/.local/bin/difyctl` にインストールし、そのディレクトリが `PATH` に含まれていない場合は通知します。
      </Tab>

      <Tab title="Windows">
        サポートするプラットフォーム：x64。

        ```powershell theme={null}
        irm https://raw.githubusercontent.com/langgenius/dify/main/cli/scripts/install.ps1 | iex
        ```

        スクリプトは `%LOCALAPPDATA%\difyctl\bin\difyctl.exe` にインストールし、そのディレクトリがまだ `PATH` にない場合は、`PATH` に追加するコマンドを表示します。
      </Tab>

      <Tab title="手動ダウンロード">
        1. [Dify の GitHub Releases](https://github.com/langgenius/dify/releases) から、サーバーの Dify バージョンに合うリリースを選び、2 つのアセットをダウンロードします：

           * お使いのプラットフォーム向けのバイナリ（`difyctl-v<version>-<os>-<arch>`）
           * チェックサムマニフェスト（`difyctl-v<version>-checksums.txt`）

        2. バイナリの SHA-256 ハッシュを計算し、checksums ファイル内の対応するエントリと比較します。

           値が一致しない場合、ダウンロードは破損しているか改ざんされています。削除して再度ダウンロードしてください。

                   <CodeGroup>
                     ```bash macOS / Linux theme={null}
                     shasum -a 256 difyctl-v<version>-<os>-<arch>
                     ```

                     ```powershell Windows theme={null}
                     Get-FileHash difyctl-v<version>-windows-x64.exe
                     ```
                   </CodeGroup>

        3. バイナリを `PATH` に配置します：

                   <CodeGroup>
                     ```bash macOS / Linux theme={null}
                     chmod +x difyctl-v<version>-<os>-<arch>
                     mv difyctl-v<version>-<os>-<arch> ~/.local/bin/difyctl
                     ```

                     ```powershell Windows theme={null}
                     New-Item -ItemType Directory -Force "$env:LOCALAPPDATA\difyctl\bin" | Out-Null
                     Move-Item difyctl-v<version>-windows-x64.exe "$env:LOCALAPPDATA\difyctl\bin\difyctl.exe"
                     ```
                   </CodeGroup>
      </Tab>
    </Tabs>

    <Tip>
      インストールをカスタマイズするには、インストールコマンドに次の環境変数を設定します。

      | 変数                | 説明                                                                                                                                                    | 例             |
      | ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | ------------- |
      | `DIFY_VERSION`    | `difyctl` を取得する Dify リリースタグ。[Dify Releases](https://github.com/langgenius/dify/releases) のタグと一致させる。<br /><br />既定は最新リリース。サーバーが最新でない場合は、そのリリースタグを指定する。 | `1.15.0`      |
      | `DIFYCTL_VERSION` | 特定の `difyctl` ビルドに固定する。`DIFY_VERSION` が未設定のときのみ使用される。                                                                                                 | `0.1.0-alpha` |
      | `DIFYCTL_PREFIX`  | インストール先ディレクトリ（既定は `~/.local`）。バイナリは `<prefix>/bin` に配置される。                                                                                            | `/usr/local`  |

      例：

      <CodeGroup>
        ```bash macOS / Linux theme={null}
        curl -fsSL https://raw.githubusercontent.com/langgenius/dify/main/cli/scripts/install-cli.sh | DIFY_VERSION=1.15.0 sh
        ```

        ```powershell Windows theme={null}
        # PowerShell にインライン形式はなく、設定はそのセッションの間ずっと有効です
        $env:DIFY_VERSION = "1.15.0"
        irm https://raw.githubusercontent.com/langgenius/dify/main/cli/scripts/install.ps1 | iex
        ```
      </CodeGroup>
    </Tip>
  </Step>

  <Step title="インストールの確認">
    ```bash theme={null}
    difyctl version
    ```

    バージョンとプラットフォームを含む `Client:` ブロックが表示されるはずです。

    代わりに `command not found` が表示される場合、インストールディレクトリが `PATH` に含まれていません。次のように追加します：

    <CodeGroup>
      ```bash macOS / Linux theme={null}
      # add to ~/.zshrc or ~/.bashrc; running it inline only lasts until the session ends
      export PATH="$HOME/.local/bin:$PATH"
      ```

      ```powershell Windows theme={null}
      [Environment]::SetEnvironmentVariable('PATH', "$env:LOCALAPPDATA\difyctl\bin;$env:PATH", 'User')
      ```
    </CodeGroup>
  </Step>
</Steps>

## アップデート

`difyctl` をアップデートするには、インストールスクリプトを再実行します。既存のバイナリがそのまま置き換わります。特定の Dify バージョンに切り替えるには、上記のとおり `DIFY_VERSION` を設定します。

## アンインストール

<CodeGroup>
  ```bash macOS / Linux theme={null}
  rm ~/.local/bin/difyctl
  ```

  ```powershell Windows theme={null}
  Remove-Item -Recurse "$env:LOCALAPPDATA\difyctl"
  ```
</CodeGroup>

アンインストール前にサインアウトするには、[`difyctl auth logout`](/ja/cli/reference/auth-and-contexts#サインアウト) を実行します。

## 次のステップ

`difyctl` をインストールしたら、[クイックスタート](/ja/cli/quick-start) に進んでサインインし、最初のアプリを実行します。