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.
difyctl requires Dify 1.15.0 or later.
Install
Run the Installer
difyctl ships a build with each Dify release, and the installer fetches the latest by default. macOS / Linux
Windows
Manual Download
Supported platforms: macOS and Linux, x64 and arm64.curl -fsSL https://raw.githubusercontent.com/langgenius/dify/main/cli/scripts/install-cli.sh | sh
~/.local/bin/difyctl and tells you if that directory isn’t on your PATH. Supported platform: x64.irm https://raw.githubusercontent.com/langgenius/dify/main/cli/scripts/install.ps1 | iex
%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.
shasum -a 256 difyctl-v<version>-<os>-<arch>
-
Put the binary on your
PATH:
chmod +x difyctl-v<version>-<os>-<arch>
mv difyctl-v<version>-<os>-<arch> ~/.local/bin/difyctl
To customize the install, set any of these environment variables on the install command.| Variable | Description |
|---|
DIFY_VERSION | The Dify release tag to install difyctl from. Defaults to the latest release; set it to your server’s release tag when your server isn’t on the latest. |
DIFYCTL_VERSION | Pin a specific difyctl build. Used only when DIFY_VERSION is unset. |
DIFYCTL_PREFIX | The install directory (default ~/.local). The binary lands in <prefix>/bin. |
curl -fsSL https://raw.githubusercontent.com/langgenius/dify/main/cli/scripts/install-cli.sh | DIFY_VERSION=<dify-version> sh
Verify the Install
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 ends
export PATH="$HOME/.local/bin:$PATH"
Update
To update difyctl, re-run the install script; it replaces the binary in place. To move to a specific Dify version, set DIFY_VERSION as above.
Uninstall
To sign out before uninstalling, run difyctl auth logout.
Next Steps
With difyctl installed, head to the Quick Start to sign in and run your first app.
