Install the CLI

Install the easyenv CLI with one line on macOS, Linux or Windows. It is a single static Go binary; releases and the install scripts live at github.com/donedeploy/easyenv-cli.

Source of truth#

Pre-built CLI binaries, the canonical install manual, and the issue tracker all live in one place on GitHub:

github.com/donedeploy/easyenv-cli
The instructions below mirror the README and may lag a release or two behind. When in doubt, follow the steps in the repo: github.com/donedeploy/easyenv-cli.

Install#

On macOS and Linux:

bash
curl -fsSL https://get.easyenv.io/cli | sh

On Windows, in PowerShell:

powershell
irm https://get.easyenv.io/cli.ps1 | iex

Both install the latest release. The script picks the build for your OS and CPU, checks it against the release's checksums.txt and stops if it does not match, then puts easyenv in /usr/local/bin (with sudo only when it has to) or, without sudo, in ~/.local/bin. On Windows it goes to $HOME\bin, which is added to your user Path once. The scripts are install.sh and install.ps1 in the CLI repo, if you want to read them first. To install a particular release, set EASYENV_VERSION:

bash
curl -fsSL https://get.easyenv.io/cli | EASYENV_VERSION=0.6.0 sh

To do it by hand instead, each release on github.com/donedeploy/easyenv-cli/releases has a bare binary per platform (easyenv_<version>_linux_amd64, linux_arm64, darwin_amd64, darwin_arm64, windows_amd64.exe), the same binary in a .tar.gz or .zip, and a checksums.txt. Download the one for your OS and architecture, make it executable, and put it on your PATH as easyenv.

The commands that reach a machine use your local OpenSSH client, which macOS, Linux and Windows 10+ already ship; machine sync and here sync also need rsync. Nothing else: no VPN client and no sshpass.

Verify the install#

you@laptop: ~
you@laptop:~$ easyenv --version
easyenv version 0.6.1 (commit a3f8c2d, built 2026-11-12)
you@laptop:~$ easyenv --help
Available Commands:
auth Manage CLI credentials (login, logout, whoami, token).
account List, switch, and inspect EasyEnv.io accounts.
workspace Manage workspaces (lifecycle + connectivity).
machine Manage machines inside a workspace (lifecycle + I/O).
here Project shortcuts that act on .easyenv/workspace.yml in cwd.
status Show server reachability and which account is in use.

Shell completion#

The CLI ships with completion scripts for bash, zsh, fish, and PowerShell.

bash
# zsh (one-off)
source <(easyenv completion zsh)

# zsh (persistent)
easyenv completion zsh > "${fpath[1]}/_easyenv"

# bash
easyenv completion bash > /etc/bash_completion.d/easyenv

# fish
easyenv completion fish > ~/.config/fish/completions/easyenv.fish

Upgrade#

Run the install line again: it replaces the easyenv already on your PATH where it is, so you never end up with two copies. The CLI checks for a newer release at most once a day and, when there is one, prints a one-line notice on stderr after the command finishes. It never checks in CI; set EASYENV_NO_UPDATE_CHECK=1 to turn it off anywhere else.

File issues and feature requests at github.com/donedeploy/easyenv-cli/issues.

Install the CLI | Docs | EasyEnv