Install difyctl with a one-line script or a manual binary download
difyctl is a standalone binary with no runtime dependencies. The install script detects your platform, downloads the matching build from Dify’s GitHub Releases, verifies its checksum, and puts the binary in place.
The script installs to %LOCALAPPDATA%\difyctl\bin\difyctl.exe and prints the command to add that directory to your PATH if it isn’t already there.
From Dify’s GitHub Releases, pick the release that matches your server’s Dify version and download two assets:
The binary for your platform (difyctl-v<version>-<os>-<arch>)
The checksum manifest (difyctl-v<version>-checksums.txt)
Compute the binary’s SHA-256 hash and compare it with the matching entry in the checksums file.If the values differ, the download is corrupted or was tampered with; delete it and download again.
To customize the install, set any of these environment variables on the install command.
Variable
Description
Example
DIFY_VERSION
The Dify release tag to install difyctl from, matching a tag on Dify’s Releases.
Defaults to the latest release; set it to your server’s release tag when your server isn’t on the latest.
1.15.0
DIFYCTL_VERSION
Pin a specific difyctl build. Used only when DIFY_VERSION is unset.
0.1.0-alpha
DIFYCTL_PREFIX
The install directory (default ~/.local). The binary lands in <prefix>/bin.
/usr/local
For example:
curl -fsSL https://raw.githubusercontent.com/langgenius/dify/main/cli/scripts/install-cli.sh | DIFY_VERSION=1.15.0 sh
# PowerShell has no inline form; this applies for the rest of your session$env:DIFY_VERSION = "1.15.0"irm https://raw.githubusercontent.com/langgenius/dify/main/cli/scripts/install.ps1 | iex
2
Verify the Install
difyctl version
You should see a Client: block with the version and platform.If you get command not found instead, the install directory isn’t on your PATH. Add it:
# add to ~/.zshrc or ~/.bashrc; running it inline only lasts until the session endsexport PATH="$HOME/.local/bin:$PATH"
