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

Run the command for your platform. You can also install the CLI later from Devsy Desktop.

MacOS Silicon/ARM

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 devsy

MacOS Intel/AMD

curl -L -o devsy "https://github.com/devsy-org/devsy/releases/latest/download/devsy-darwin-amd64" && sudo install -c -m 0755 devsy /usr/local/bin && rm -f devsy

Windows

md -Force "$Env:APPDATA\devsy"; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.SecurityProtocolType]'Tls,Tls11,Tls12';
Invoke-WebRequest -URI "https://github.com/devsy-org/devsy/releases/latest/download/devsy-windows-amd64.exe" -OutFile $Env:APPDATA\devsy\devsy.exe;
$env:Path += ";" + $Env:APPDATA + "\devsy";
[Environment]::SetEnvironmentVariable("Path", $env:Path, [System.EnvironmentVariableTarget]::User);

Linux AMD

curl -L -o devsy "https://github.com/devsy-org/devsy/releases/latest/download/devsy-linux-amd64" && sudo install -c -m 0755 devsy /usr/local/bin && rm -f devsy

Linux ARM

curl -L -o devsy "https://github.com/devsy-org/devsy/releases/latest/download/devsy-linux-arm64" && sudo install -c -m 0755 devsy /usr/local/bin && rm -f devsy

Confirm the CLI is on your PATH:

devsy --version

Next step

Create your first workspace in the Quick Start.