help request: If apisix support install on Alamalinux 9.6

[jujiale]

Description

hello, we now use Alamalinux 9.6. I want to know if apisix support install on alamalinux. I use alamalinux to install apisix3.13.0, but failed

Environment

• APISIX version (run apisix version):
• Operating system (run uname -a):
• OpenResty / Nginx version (run openresty -V or nginx -V):
• etcd version, if relevant (run curl http://127.0.0.1:9090/v1/server_info):
• APISIX Dashboard version, if relevant:
• Plugin runner version, for issues related to plugin runners:
• LuaRocks version, for installation issues (run luarocks --version):

[SkyeYoung]

Currently, there are no packages directly marked as supporting AlmaLinux.

Have you tried the Centos 8 package described in #12460?

Also, could you provide the specific installation steps you used?

[jujiale]

@SkyeYoung
we only could use the os mirror that our company provided, centos8 is not provided in our company(our company os mirror is self customed).

alamalinux 9.6 will provided to us in september, I install a alamalinux 9.6 in my vmvare to test install apisix, but failed, I will do some research to look up the issue.

this issue I submit is I want to know if the lastest apisix could installed on alamalinux, if not, I will do not research it (because of the time limt).

I will continue try to install it on alamalinux this afternoon, if it still failed, I will add more details.

thank a lot for you reply.

[jujiale]

and I think apisix should also provide centos7 rpm package, at least apply apisix-runtime. because in some company, they could not upgrade their os casually, and in some network env, build centos7 apisix-runtime rpm package is very hard, I think apisix should also provide to centos7 build tool or rpm package for those who could not upgrade os conveniently. because maybe exist some company which also use apisix in centos7 os.

[jujiale]

the below is the failed output:
`

[root@master yum.repos.d]# sudo yum install -y https://repos.apiseven.com/packages/centos/apache-apisix-repo-1.0-1.noarch.rpm
  上次元数据过期检查：0:02:10 前，执行于 2025年08月14日 星期四 13时25分46秒。
  apache-apisix-repo-1.0-1.noarch.rpm                                                                                                                                                                     15 kB/s | 2.6 kB     00:00    
  软件包 apache-apisix-repo-1.0-1.noarch 已安装。
  依赖关系解决。
  无需任何处理。
  完毕！


  [root@master yum.repos.d]# sudo yum-config-manager --add-repo https://repos.apiseven.com/packages/centos/apache-apisix.repo
  添加仓库自：https://repos.apiseven.com/packages/centos/apache-apisix.repo


  [root@master yum.repos.d]# sudo yum install apisix
  Apache APISIX Repository for CentOS                                                                                                                                                                    1.0 kB/s | 466  B     00:00    
  Errors during downloading metadata for repository 'release':
    - Status code: 404 for https://repos.apiseven.com/packages/centos/9/x86_64/repodata/repomd.xml (IP: 59.52.143.59)
  错误：为仓库 'release' 下载元数据失败 : Cannot download repomd.xml: Cannot download repodata/repomd.xml: All mirrors were tried

`

[jujiale]

`

      [root@master etc]# cat /etc/os
  os-release  ostree/     
  [root@master etc]# cat /etc/os-release 
  NAME="AlmaLinux"
  VERSION="9.6 (Sage Margay)"
  ID="almalinux"
  ID_LIKE="rhel centos fedora"
  VERSION_ID="9.6"
  PLATFORM_ID="platform:el9"
  PRETTY_NAME="AlmaLinux 9.6 (Sage Margay)"
  ANSI_COLOR="0;34"
  LOGO="fedora-logo-icon"
  CPE_NAME="cpe:/o:almalinux:almalinux:9::baseos"
  HOME_URL="https://almalinux.org/"
  DOCUMENTATION_URL="https://wiki.almalinux.org/"
  BUG_REPORT_URL="https://bugs.almalinux.org/"
  
  ALMALINUX_MANTISBT_PROJECT="AlmaLinux-9"
  ALMALINUX_MANTISBT_PROJECT_VERSION="9.6"
  REDHAT_SUPPORT_PRODUCT="AlmaLinux"
  REDHAT_SUPPORT_PRODUCT_VERSION="9.6"
  SUPPORT_END=2032-06-01
  
  
  
  [root@master etc]# uname -a
  Linux master 5.14.0-570.12.1.el9_6.x86_64 #1 SMP PREEMPT_DYNAMIC Tue May 13 06:11:55 EDT 2025 x86_64 x86_64 x86_64 GNU/Linux

`

[jujiale]

maybe the result is the almalinux https://repos.apiseven.com/packages/centos/9/x86_64/repodata/repomd.xml, the https://repos.apiseven.com/packages/centos/8/x86_64/repodata/repomd.xml could get

[SkyeYoung]

@jujiale

centos7

CentOS 7 has not been maintained for a long time, and there may be many potential problems. If you are willing, you can submit a PR to maintain the CentOS 7 packages.

In addition, I'm not very familiar with the versions of AlmaLinux. Does 9.6 at least correspond to CentOS Stream 9?

I see that some of the information you've posted seems to be the same, and I don't quite understand why we need to discuss CentOS 7.

[SkyeYoung]

@jujiale Another question is, does your company provide Alama Linux corresponding to CentOS 8? This seems to solve the problem faster.

[jujiale]

@SkyeYoung
It seems the Almalinux9 is not corresponding to CentOS8, 9.6 seems correspond to CentOS Stream 9. I will try some other ways. thanks a lot

[SkyeYoung]

@jujiale The reason why there are currently no packages for AlamaLinux 9 (or CentOS Stream 9 or Rocky Linux) is because the community has not yet received feedback from more companies or organizations.

I think this can be a discussion, pending further comments.

For the current situation, I recommend using a system compatible with CentOS 8, or Docker, K8s.

If you are interested, you can maintain the software package and publish it to the corresponding software source. Any PR is welcome.

[dosubot[bot]]

APISIX does not officially support installation on AlmaLinux 9.6 via RPM, as the RPM repositories and guides are targeted at CentOS 7/8 and do not mention AlmaLinux or RHEL 9.x compatibility. This is likely why your installation failed—AlmaLinux 9.6 uses different package versions and dependencies than those provided in the official RPM repos, which can cause conflicts or missing dependencies source.

You can still run APISIX on AlmaLinux 9.6 using alternative methods:

Docker:
This is the most environment-agnostic option. Clone the apisix-docker repo, go to the example directory, and start APISIX with:

docker-compose -p docker-apisix up -d

This method bundles all dependencies, including NGINX and etcd, so you don't need to install them separately source.

Helm (Kubernetes):
If you have a Kubernetes cluster, you can deploy APISIX using Helm:

helm repo add apisix https://charts.apiseven.com
helm repo update
helm install apisix apisix/apisix --create-namespace --namespace apisix

Helm handles dependencies and configuration for you source.

Build from Source:
You can also build APISIX from source. Download the source package, install dependencies (OpenResty, etcd, LuaRocks, etc.), then run:

make deps
make install

This approach works on most RHEL-compatible systems, including AlmaLinux, but may require manual troubleshooting for missing libraries source.

If you want help troubleshooting your RPM installation, please share the specific error message or log output you encountered. Otherwise, I recommend Docker or Helm for the smoothest experience on AlmaLinux 9.6.

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}