Install Devsy
Devsy comes in two forms that share the same workflow:
- Devsy Desktop — a guided app for creating and managing workspaces. Start here if you want a UI.
- Devsy CLI — the same workflow from a terminal, for automation and scripting.
Install either one below, then head to the Quick Start.
Install Devsy Desktop
Download the build for your platform:
- macOS Silicon/ARM
- macOS Intel/AMD
- Windows
- Linux AppImage
- Linux DEB (Debian/Ubuntu)
- Linux RPM (Fedora/RHEL/openSUSE)
- Linux Flatpak
For earlier versions, see the GitHub releases page.
Linux dependencies
The DEB and RPM packages declare their runtime dependencies; the AppImage and Flatpak bundle theirs. Most modern desktop distros run the AppImage as-is (tested on Debian 12+, Ubuntu 22.04+, Fedora 36+, openSUSE Leap 15.3+, Tumbleweed, and Arch).
If the AppImage fails to launch, install FUSE and the GTK/Electron runtime libraries:
- Debian/Ubuntu:
sudo apt-get install libfuse2 libgtk-3-0 libnotify4 libnss3 libxss1 libxtst6 xdg-utils libatspi2.0-0 - Fedora:
sudo dnf install fuse-libs gtk3 libnotify nss libXScrnSaver libXtst xdg-utils at-spi2-core - openSUSE:
sudo zypper in libfuse2 gtk3 libnotify4 mozilla-nss libXss1 libXtst6 xdg-utils
Windows dependency
Devsy Desktop needs WebView 2. It ships with recent versions of Windows — install it only if the app fails to open.
Install Devsy CLI
On macOS or Linux, the quickest option is the install script:
curl -L https://devsy.sh/install.sh | shThe script detects your OS and CPU architecture, downloads the latest CLI build from GitHub releases, verifies its SHA-256 checksum when the release publishes one, and installs devsy into /usr/local/bin (or ~/.local/bin when /usr/local/bin isn't writable). Re-run it any time to get the latest release. On Windows, use the PowerShell command in the Windows tab below.
Two environment variables customize the script:
DEVSY_VERSIONinstalls a specific release instead of the latest:curl -L https://devsy.sh/install.sh | DEVSY_VERSION=v1.19.0 shDEVSY_INSTALL_DIRinstalls somewhere other than the default:curl -L https://devsy.sh/install.sh | DEVSY_INSTALL_DIR="$HOME/bin" sh
On macOS or Linux, you can also install with Homebrew:
brew install devsy-org/homebrew-tap/devsyUpgrade later with brew upgrade devsy.
To download a binary yourself, run the command for your platform below. You can also install the CLI later from Devsy Desktop.
curl -L -o devsy "https://github.com/devsy-org/devsy/releases/latest/download/devsy-darwin-arm64" && sudo install -c -m 0755 devsy /usr/local/bin && rm -f devsyConfirm the CLI is on your PATH:
devsy --versionNext step
Create your first workspace in the Quick Start.