Skip to main content

How to build Apache APISIX in ARM Ubuntu

· 5 min read
Qi Guo

By reading this article you will learn how to build Apache APISIX (M1 chip environment) in ARM Ubuntu from source code. The ARM Ubuntu system is installed with the help of


Clone source code#

First follow the official documentation. Clone the Apache APISIX source code repository and go to the project directory.

git clone apisixgit checkout release/2.11

Install OpenResty#

First, install the dependencies required for the project in one click via an automation script, running the following command in the project root directory.

bash utils/

Installation dependency.png

As you can see from the error message, it is due to the failure to install OpenResty successfully. The root cause is that there is no source for the ARM 64 platform by default.

Here we install OpenResty manually, the installation steps can be found at

Step 1: Install the several dependencies required to import the GPG public key#

Specific code examples can be found below (you can delete them at any time after the entire installation process is complete).

sudo apt-get -y install --no-install-recommends wget gnupg ca-certificates

Step 2: Import GPG key#

wget -O - | sudo apt-key add -

The import was successful as shown in the figure below.

Import GPG key.png

Step 3: Add the official OpenResty APT repository#

For x86_64 or amd64 systems, the following command can be used.

echo "deb $(lsb_release -sc) main" \    | sudo tee /etc/apt/sources.list.d/openresty.list

For ARM64 or aarch64 systems, you can use the following command (run on M1 to run the command, the last command will report an error).

echo "deb $(lsb_release -sc) main" \    | sudo tee /etc/apt/sources.list.d/openresty.list

Step 4: Update the APT Index#

sudo apt-get update

After that, you can install the software package according to the code below. Here we take OpenResty as an example.

sudo apt-get -y install openresty

Step 5: Delete the corresponding associated package (optional)#

Finally, we can delete the package and its corresponding associated package with the following command.

sudo apt-get -y install --no-install-recommends software-properties-common

Successful installation of OpenResty.

OpenResty installed successfully.png

Install Dependencies#

First rerun the installation dependency script. Then run the command LUAROCKS_SERVER= to install the dependencies.

bash utils/

Install dependency.png

Simply run the following command.

curl -sL | bash -

Installation dependency feedback.png

Find the error prompt based on the feedback from the figure above, and then execute the following command.

sudo apt install wget sudo unzip

Then we rerun the following command.

curl -sL | bash -

Finally, run the installation dependency instruction LUAROCKS_SERVER= make deps

Successful installation.png

At this point, most of the dependencies have been successfully installed, but a new error message appears (it looks like the two repositories failed to clone). It doesn't matter, it doesn't matter for the time being, you can execute the APISIX installation command here.

make install# If you get an insufficient permissions message, use `sudo make install`

Excute APISIX.png

Install etcd#

Before starting Apache APISIX you need to install etcd, more details can refer to the official documentation.


Because the installation tutorial was not written for arm, although etcd, was successfully installed, etcd could not be run successfully due to the default use of x86 binaries. The specific part of stepping on the pit will not be repeated here, but will directly put the correct steps for your reference.

Run the etcd in Docker#

Step 1: Install Docker#

sudo apt install

Common docker commands(add sudo before the command if you get no permission error):

  • View a list of all containers docker ps -a
  • View the list of running containers docker ps
  • View the list of images docker image list
  • Delete all containers docker container prune
  • Delete all images docker image prune -f -a

More references can refer to Docker Getting Started Tutorial - Ruan Yifeng's Weblog.

Step 2: Pull and run etcd#

sudo docker run -d --name etcd -p 2379:2379 -e ETCD_UNSUPPORTED_ARCH=arm64 -e ETCD_LISTEN_CLIENT_URLS= -e ETCD_ADVERTISE_CLIENT_URLS=

It should be noted that the proxy needs to be enabled for mirroring in this operation.

Run etcd.png

Step 3: Verify etcd status#

sudo docker ps -a

Verify that etcd is on.png

As you can see, etcd has been successfully started.

Start Apache APISIX#

After doing this, all the dependent projects are now ready, and now you are ready to start Apache APISIX.

Step 1: Install dependencies#

make depsmake install

Step 2: Initialise dependencies and start APISIX#

apisix init
# start APISIXapisix start
# stop APISIXapisix stop

APISIX started successfully.png

Apache APISIX started successfully. For more details on how to install and build Apache APISIX, please see official documentation.


Through detailed steps, this article shows you how to deploy and install Apache APISIX under Macbook M1 chip system. In overall practice, there will be some trampling process, but the overall experience is still a successful deployment.

If you have better suggestions, you are welcome to contribute to the Apache APISIX build documentation and leave your suggestions to help more people.