Topics

On this page

Last updated on Nov 3, 2026

ee cli update

Update EE to the latest release.

Default behavior is to check the releases API for the newest stable version, and prompt if one is available.

Use --stable to install or reinstall the latest stable version.

Use --nightly to install the latest built version of the develop branch. While not recommended for production, nightly contains the latest and greatest, and should be stable enough for development and staging environments.

Before it starts, the update asks you to confirm a notice: run it in tmux or screen, have at least 5 GB of free disk space, and follow progress with tail -f /opt/easyengine/logs/ee.log. --yes answers every prompt.

EasyEngine checks the download against its published md5 hash and runs the new version once before it replaces ee. The next ee command then runs the migrations for the new version, including container image updates.

On macOS, update with brew upgrade easyengine instead.

SYNOPSIS

ee cli update [--stable] [--nightly] [--yes]

OPTIONS

[--stable]
: Update to the latest stable release.

[--nightly]
: Update to the latest built version of the develop branch. Potentially unstable.

[--yes]
: Do not prompt for confirmation.

EXAMPLES

# Update to the newest release, with confirmation prompts.
$ ee cli update

# Install or reinstall the latest stable release without prompts.
$ ee cli update --stable --yes
Downloading from https://raw.githubusercontent.com/EasyEngine/easyengine-builds/master/phar/easyengine.phar...
md5 hash verified: <hash>
Updating EasyEngine to new version. This might take some time.
New version works. Proceeding to replace.
Success: Updated EE to 4.13.3.

# Install the latest nightly build (not for production).
$ ee cli update --nightly

SUBCOMMANDS

NameDescription
ee cli check-updateCheck to see if there is a newer version of EE available.
ee cli infoPrint various details about the EE environment.
ee cli self-uninstallUninstalls easyengine completely along with all sites
ee cli versionPrint EE version.

GLOBAL PARAMETERS

--sites_path=<path>
    Absolute path to where all sites will be stored.

--locale=<locale>
    Locale for WordPress.

--le-mail=<le-mail>
    Mail-id to be used for letsencrypt.

--env=<env>
    EasyEngine server environment.

--wp-mail=<wp-mail>
    Default Mail-id to be used for WordPress site installation.

--sysctl=<true/false>
    Whether to add sysctl config in docker-compose.

--skip-tty=<true/false>
    Skip tty allocation for remote command execution.

--custom-compose=<custom-compose file>
    Path to custom compose file.

--[no-]color
    Whether to colorize the output.

--debug[=<group>]
    Show all PHP errors; add verbosity to EE bootstrap.

--quiet
    Suppress informational messages.