1. Pre-requisites

a) Choose an appropriate DNS Domain Name and URL to host the QMCLOUD platform in your environment. b) Choose an appropriate name and password for the Postgres database service in QMCLOUD c) Optional - Setup, Configure AWS application load balancer Internet facing, target groups, ssl certificate or use another proxy and routing solution as per your requirements d) Create and setup appropriate DNS A/CNAME records e) Pulumi - You will need a free Pulumi account at a minimum. Refer to the documentation for further details at https://docs.qmcloud.io 

2. Launch AMI

a) Launch the marketplace AMI into a desired VPC and subnet (preferably private) b) ssh into the instance using the user ubuntu and the ssh key that was used to launch the ec2 instance c) Run the following commands/script:

cd /home/ubuntu/qcloud sudo bash start_the_containers.sh

The script does the following:

Sets the Postgres password to the ec2 instance id All the other inputs (mainly ports and names) are considered as default as listed in the script Creates .env files for each of the containers required for the application Starts all the required containers using docker run command

3. Check the status of all the containers by using this command: sudo docker ps -a

4. Optional - Setup AWS ALB (only if AWS ALB is being used for routing)

a) Create and configure two target groups / one for front end and one for backend b) Register the instance in both the target groups c) The frontend is configured to listen for port tcp/3005 d) The backend is configured to listen for port tcp/3006 d) Create the AWS application load balancer e) Create listeners for 80 and 443 each. Configure default forwarding for 80 and 443 to the front-end target group f) Configure additional rule for forwarding to backend using path-based routing for the path /api/* g) Configure DNS name for the FQDN used and point it to the CNAME of the load balancer

Note: If a user plans to use a solution other than AWS ALB, appropriate routing will need to be configured.

5. Access the app

a) Navigate to the fqdn or URL for the instance or the load balancer as appropriate b) You will be prompted for the first user registration. The software will prompt for user details for the first admin user. c) An email is sent to the email address with the link to set the password. Set the password using the link received in the email. Note that if you use a private IP address or a URL that is not accessible from the Internet, you will need to access the URL using a jump server or a server in the VPC where the instance is launched

6. You can now login using the email address and the password

Please contact us at support@appmodz.net  for further help.