# Installation ### Step 1 Set up your own [AWS account](https://portal.aws.amazon.com/billing/signup) with sufficient credit or a valid payment method. ### Step 2 [Register a root domain name](https://aws.amazon.com/route53/) you would like to use for the wallet. This will be how counterparties address users of your wallet: `person@yourdomain.com` The domain will be used as a root domain, and the cloud formation template will create subdomains under it. {% embed url="" fullWidth="false" %} ### Step 3 Pick the AWS region closest to your customer(s). To determine which region is closest to your current location you can use a service like [Cloud Ping](https://www.cloudping.info/). {% tabs %} {% tab title="AWS Console" %} **Step 4** Launch the software using one of the CloudFormation template links below for your chosen region.

Region	CloudFormation template link
AP	ap-south-1 ap-northeast-1 ap-northeast-2 ap-northeast-3 ap-southeast-1 ap-southeast-2
CA	ca-central-1
EU	eu-central-1 eu-west-1 eu-west-2 eu-west-3 eu-north-1
SA	sa-east-1
US	us-east-1 us-east-2 us-west-1 us-west-2

If you don't know which link to pick, just use [us-east-1](https://us-east-1.console.aws.amazon.com/cloudformation/home?region=us-east-1#/stacks/quickcreate?templateURL=https://spv-wallet-template.s3.eu-central-1.amazonaws.com/spv-wallet/latest/EksStack.template.json). **Step 5** Fill in the required template settings: * Stack name - this name will be dispayed on the list of Cloud Formation stacks in the AWS console * Domain name - type the domain nama that you registered at the step 2 * Hosted zone ID for domain - choose exactly the one that is matching the domain name above **Step 6** After submitting stack creation it will take up to 30 minutes to create all resources. You can check the status in the Resources tab. {% endtab %} {% tab title="AWS CLI" %} **Prerequisite** Make sure you have AWS CLI installed and authenticated


Install AWS CLI	https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html
Authenticate AWS CLI	https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html

**Step 4** Issue the following command and find hosted zone id for registered domain in the [Step 2](#step-2). :information\_source:Make sure to use the id without the prefix `/hostedzone/` ```bash aws route53 list-hosted-zones --query "HostedZones[*].[Id,Name]" --output text ``` **Step 5** Replace variables described below with chosen options in the following command and run it to deploy the stack. ```bash aws cloudformation create-stack \ --stack-name ${Stack_Name} \ --region ${AWS_Region} \ --parameters ParameterKey=domainName,ParameterValue=${Domain_Name} ParameterKey=hostedzoneId,ParameterValue=${Hosted_Zone_Id} \ --template-url https://spv-wallet-template.s3.amazonaws.com/spv-wallet/latest/EksStack.template.json --capabilities CAPABILITY_IAM ``` Where: * ${Stack\_Name} - this name will be used to refer the stack in any following command * ${AWS\_Region} - region you choose in the [Step 3](#step-3) * ${Domain\_Name} - domain name you registered in the [Step 2](#step-2) * ${Hosted\_Zone\_Id} - hosted zone id found in [Step 4](#step-4-1) **Step 6** After submitting stack creation it will take up to 30 minutes to create all resources. You can check the status by issuing the following command. ``` aws cloudformation describe-stacks --stack-name ${Stack_Name} --region ${AWS_Region} ``` {% endtab %} {% endtabs %} {% hint style="info" %} These subdomains will be created for the application * **wallet.***yourdomain.com* * **admin.***yourdomain.com* * **api.***yourdomain.com* * ***headers**.yourdomain.com* {% endhint %}

What resources are created?

· VPC with CIDR 10.0.0.0/16 · EKS Cluster with a Single Node Group (2 x t3.small instances) · Wildcard certificate in ACM for provided domain · Route53 entries for Bux components · Load Balancer Controller for EKS · SPV Wallet Components: o Web App & API o SPV Wallet Server o PostgreSQL Database o Web Admin o Block Headers Service

--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.bsvblockchain.org/network-topology/spv-wallet/aws/installation.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.