This document describe how to install edge-cli.


We will need to access the following public network addresses. If your network has a firewall, you need to add proper rules to white list them. 443 443 443 443

We need to prepare the files openresty-edge-config-VERSION.rpm or openresty-edge-config-VERSION.deb.


  • Please login openresty website.

  • Go to OpenResty Download Center.

  • Download the openresty-edge-config package

    If your system is debian, ubuntu, you should download openresty-edge-config-VERSION.deb.

    If your system is centos, fedora, rhel, you should download openresty-edge-config-VERSION.rpm.

  • Copy openresty-edge-config to the current directory.

  • Download the installation script:

    curl -O

    If you got a message like the following:

    curl: command not found

    It is possible that curl is not installed on the system or that the system shell program does not contain a search path for curl.

    You can use the absolute path to retry.

    /usr/bin/curl -O

    Your system’s path may be different, contact your webmaster or use a command such as which bash to check the path to correct the situation.

  • Execute the installation script:

    Note, you should put and openresty-edge-config package in the same directory.

    sudo /bin/bash

Set path

please set PATH environment in ~/.bash_profile.

export PATH=/usr/local/oredge-admin/bin:$PATH

Add config file

If you don’t know how to get api_token, please goto API Token document.

Add config to ~/.oredge/config.

mkdir ~/.oredge

cat << EOF > ~/.oredge/config

The cli should be installed. Try it by:

oredge --help

Docker image of edge-cli

We provide edge-cli docker image to make use it more easily.


You can download edge-cli use the command below.

docker pull


docker pull

To specify edge-cli version by docker image’s tag. You can list all docker image’s tags use the command below.

# curl -s "" | json_pp
   "name" : "edge-cli/fedora32/openresty-edge-cli",
   "tags" : [


You can run the container use the command below.

docker run -ti --rm \
    -v ~/.oredge/config:/root/.oredge/config \ /bin/bash

Now you can use oredge command.

Use -v /path/to/your/config:/root/.oredge/config to mount your edge-cli configuration.

Here are the example contents of the configuration.


If you don’t know how to get api_token, please goto API Token document.