Install

Instructions for installing Easegress from pre-built binaries or from source.

Install pre-built binaries

The easiest way to install Easegress is by using pre-built binaries:

1. Download the appropriate compressed archive file for your platform from Releases.
2. Extract the contents of the archive, which will create a directory containing the binaries.
3. Add the extracted binaries to your system's path. You can either move and/or rename the binaries to a directory already in your path (such as /usr/local/bin), or add the newly created directory to your path.

From a shell, test that Easegress is in your path:

$ easegress-server --version
Easegress v2.6.1

Build from source

1. Either download the Easegress repo as a ZIP file from here, or clone the repo with the following command:

   $ git clone https://github.com/megaease/easegress.git

2. Navigate to the Easegress directory:

   $ cd easegress

3. Execute the build script to generate the binaries, which will be placed in the bin directory:

   $ make

4. Add the bin directory to your system's path:

   $ export PATH="$PATH:`pwd`/bin" 

5. Verify that easegress-server has been successfully added to your path:

   $ easegress-server --version

Note:

• This repo requires Go 1.20+ compiler for the build.
• If you need the WebAssembly feature, please run make wasm.

Install via Systemd Service

To install the Systemd service, execute the following command:

$ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/megaease/easegress/main/scripts/install.sh)"

Install via Docker

1. Pull the latest image from Docker Hub:

   $ docker pull megaease/easegress:latest

2. Run the pulled image:

   $ docker run megaease/easegress