Skip to main content

Version: 3.9.0

Install APISIX on ROSA

Red Hat OpenShift Service on AWS (ROSA) is a fully managed service that provides a simplified way to deploy and manage OpenShift clusters on AWS.


Create a OpenShift Project and Service Account

Log in OpenShift CLI using the user account with cluster admin rights:

oc login <cluster-url> --username <username> --password <password>

Create an OpenShift project for APISIX:

oc new-project apisix

Switch the default project to apisix:

oc project apisix

Create a service account apisix-sa for APISIX deployment:

oc create sa apisix-sa

Add the security context constraint (SCC) anyuid to the service account:

oc adm policy add-scc-to-user anyuid -z apisix-sa

Install With Helm

Add APISIX Helm repository and update:

helm repo add apisix
helm repo update

Install the APISIX Helm chart:

helm install apisix apisix/apisix \
--set gateway.type=NodePort \
--set etcd.podSecurityContext.enabled=false \
--set etcd.containerSecurityContext.enabled=false \

❶ Disable podSecurityContext and containerSecurityContext for etcd to avoid running into issues related to SCC.

❷ Deploy with the service account apisix-sa to grant APISIX the required permissions.

If successful, you should see a response similar to the following:

NAME: apisix
LAST DEPLOYED: Wed May 24 07:56:25 2023
STATUS: deployed

Verify Installation

Check pod statuses to make sure all pods are up and running:

oc get pod

The response should be similar to the following with all pods Running:

NAME                      READY   STATUS    RESTARTS   AGE
apisix-5899557df4-5wgcn 1/1 Running 0 6m33s
apisix-etcd-0 1/1 Running 0 6m33s
apisix-etcd-1 1/1 Running 0 6m33s
apisix-etcd-2 1/1 Running 0 6m33s

Send a request to APISIX to verify APISIX is running:

oc exec -itq apisix-5899557df4-5wgcn -- curl -I | grep Server

You should see APISIX version in the response:

Server: APISIX/3.9.0

You have now successfully installed APISIX on ROSA. Logo

API Management for Modern Architectures with Edge, API Gateway, Kubernetes, and Service Mesh.


API7 Cloud

SOC2 Type IRed Herring

Copyright © APISEVEN Ltd. 2019 – 2024. Apache, Apache APISIX, APISIX, and associated open source project names are trademarks of the

Apache Software Foundation