Deploy on AWS using CloudFormation

Use our CDK script to deploy the entire Hyperswitch application inside your stack

In this chapter, you will deploy our full-stack application on AWS EKS. This will deploy our app server, web client and control center

---

Video

What is included in this setup

The following components and services will be deployed in a new stack in your AWS account

Component	Instance Type	Default Configuration
EKS (1 Cluster)	t3.medium	2 Nodes
Load Balancer	Application LB	2 LBs
RDS	t4g.medium	2 cluster
ElastiCache	t4g.medium	1 cluster
EC2	t3.medium	1 instance

The following services will be installed in the 2 Nodes inside your EKS cluster

Service Name	Number of Pods	Default Configuration
Hyperswitch App Server	3 pods	CPU : 400m Memory : 500 Mi
Producer (Scheduler)	1 pod	CPU : 100m Memory : 100 Mi
Consumer (Scheduler)	1 pods	CPU : 100m Memory : 100 Mi
Promtail	Daemon Set (will be deployed in every node)	CPU : 200m Memory : 128 Mi
Loki	1 pod	CPU : 100m Memory : 128 Mi
Grafana	1 pod	CPU : 100m Memory : 128 Mi
Control Center	1 pod	CPU : 100m Memory : 100 Mi
Hyperswitch Demo Store	1 pod	CPU : 100m Memory : 100 Mi

Steps to Deploy Hyperswitch on AWS

Prerequisites

• git installed on your local machine

• node version 18

• An AWS user account with admin access (you can create an account here if you do not have one)

Step 1 - [Optional] - Create a new user with Admin access (if you do not have a non-root user)

• Create a new user in your AWS account from IAM -> Users (as shown below)

• While setting permissions, provide admin access to the user

Step 2 - Configure your AWS credentials in your terminal

For this step you would need the following from your AWS account

1. Preferred AWS region

2. Access key ID

3. Secret Access Key

4. Session Token (if you MFA set up)

You can create or manage your access keys from IAM > Users inside your AWS Console. For more information, click here

Once you have the keys run the below command

export AWS_DEFAULT_REGION=<Your AWS_REGION> // e.g., export AWS_DEFAULT_REGION=us-east-2
export AWS_ACCESS_KEY_ID=<Your Access_Key_Id> // e.g., export AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
export AWS_SECRET_ACCESS_KEY=<Your Secret_Access_Key> // e.g., export AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
export AWS_SESSION_TOKEN="<Your AWS_SESSION_TOKEN>" //optional

Step 3 - Deploy Hyperswitch application

Run the below commands in the same terminal session

git clone https://github.com/juspay/hyperswitch-cdk.git
cd hyperswitch-cdk
bash install.sh

Once the script is run you will have to provide the following as inputs

1. Provide a DB password of your choice (should be more than 8 chars)

2. Provide an Admin Api key of your choice for Hyperswitch APIs

3. If you choose to opt-in for the card vault service, provide a master-key when prompted (command to generate the master-key will be displayed on the terminal; also note down the two custodian keys to start the locker)

   • Provide the Locker DB password of your choice when prompted

After the deployment is completed, use the custodian keys to activate the locker (You can find the cURLs here). The host URL of the locker to run these cURLs will be displayed on terminal

Make sure to save the passwords you provide while running the script

Output

On successful execution of the script, you will receive the following outputs

Output	What is it used for
Hostname of the app server	Access the application's APIs using the given base URL
Hostname of the log server	View real-time logs for all processes
Control Center URL	Access the Hyperswitch control center and explore multiple settings
Hyperloader.js URL	Use the hyperloader to integrate our web client in your website
Demo App URL	Test payments quickly using our web checkout in the demo store
Locker URL	Access the Hyperswitch card vault using this host URL

That's it! Hyperswitch should be up and running on your AWS account. Open the Demo Store and make a test transaction using any test card 🎉🎉

Estimated cost of running the above setup

The table below offers an estimated cost for operating the setup generated by the CDK script within your AWS environment. This cost is computed under the following assumptions:

• The system is handling a traffic of 1000 transactions per day

• The number of hours per month for each component is 720 (24*30)

Component	Instances	Storage	Throughput cost	Total Cost ($)
EKS	1 cluster	-		73
EC2	3 x t3.medium	-		45.11
Aurora Postgresql	1 x t3.medium	500 MB * ( 0.05 USD) Assuming 30k transactions per month	0.07 USD ** (3 baseline i/o per minute, 9 peak i/o per minute)	59.98 (59.86 + 0.05 + 0.07)
ElastiCache	1 x t3.micro	-		12.24
S3	1	1 GB	0.24 *** (290 GB outbound data transfer assuming 1000 new user logins per day)	1.14
Load Balancer	4	-		65.72
Total				257.19

*Avg data written per transaction = 16 kb

**Assuming 3.5k API requests per day with 5 i/o operations each and 18 hours peak time per day

***Assuming 30 GET requests per login. Avg new user would receive 10 mb data per request. For 1000 new logins the data transfer = (10*30*1000*) / 1024 ~ 290 GB

FAQs

1. Why use AWS EKS for deploying Hyperswitch? AWS Elastic Kubernetes Service (EKS) provides a managed Kubernetes cluster, ensuring high availability and scalability for Hyperswitch.

2. How do I deploy Hyperswitch on EKS using Helm charts? You can deploy Hyperswitch on EKS by following our Helm chart documentation, which provides step-by-step instructions.

3. What versions of EKS are supported for deploying Hyperswitch? Hyperswitch supports all versions of EKS that are officially provided by AWS.

4. Can I use my existing RDS instance for the database with Hyperswitch? Yes, you can configure Hyperswitch to use your existing RDS instance as the database.

5. What database engines are supported for RDS when using Hyperswitch? Hyperswitch supports various database engines, including PostgreSQL, MySQL, SQL Server, and Oracle, depending on your requirements.

6. How do I configure RDS with Hyperswitch using Helm charts? Our Helm chart documentation provides detailed instructions for setting up RDS as the database for Hyperswitch.

7. Do I need to make any specific configurations in RDS for Hyperswitch to work optimally? Yes, you may need to configure database parameters such as connection limits and database user credentials. Consult the documentation for details.

8. Can I use Amazon Elastic Cache (Redis) as a caching layer with Hyperswitch? Yes, you can configure Hyperswitch to use Amazon Elastic Cache (Redis) for caching purposes, which can improve performance.

9. What Redis configurations are recommended for optimal performance with Hyperswitch? The recommended Redis configurations can vary based on your workload, but you should typically configure Redis to use the appropriate instance type and set the eviction policies correctly.

10. How can I scale Hyperswitch on EKS to handle increased traffic? You can scale Hyperswitch by adjusting the number of pods in the deployment or using Kubernetes' Horizontal Pod Autoscaling based on resource utilization.

11. How can I monitor the performance and health of Hyperswitch on EKS? You can Use AWS CloudWatch, Prometheus, or other monitoring solutions to track performance metrics and set up alerts. Refer our guide for more information

12. Is there a recommended backup and disaster recovery strategy for Hyperswitch and associated AWS resources? Yes, it's essential to implement regular backups for RDS and have a disaster recovery plan in place. AWS provides tools and services for this purpose.

13. Are there any specific security considerations when deploying Hyperswitch on AWS EKS? You should follow our best practices for securing your EKS cluster and your Hyperswitch application, including network policies, IAM roles, and encryption.

14. How do I upgrade Hyperswitch and its dependencies on EKS? Please refer to the Updates section for more details

15. What do I do if I encounter issues during the deployment process? If you encounter issues, consult the troubleshooting section of the documentation or reach out to our support team for assistance.

16. Where can I find further documentation on Hyperswitch? You can find additional documentation, tutorials, and support resources on our website and in our api docs.

Next step:

Account setup