• Thank you for choosing the Groot app. We are pleased to have you with us. Enclosed is the documentation to help you set up and launch the app easily. Please read it carefully, as it contains important information. If you need any assistance or have questions, our support team is just a message away.

• All setup is performed using Terminal (SSH).
• Connect to your AWS server using:

ssh ubuntu@YOUR_SERVER_IP

• Upload the backend zip file using WinSCP or SCP.
• Navigate to your project directory and extract:

cd /home/ubuntu/backend unzip backend.zip -d backend

• Launch an AWS EC2 Instance.
• Instance Type: t3a.medium
• Operating System: Ubuntu 24.04 LTS
• Enable ports in Security Group:
• 22 – SSH
• 80 – HTTP
• 443 – HTTPS
• Attach key pair and launch the instance.

• Update system packages:

sudo apt update && sudo apt upgrade -y

• Install MariaDB (MySQL compatible):

sudo apt install mariadb-server -y

• Verify version:

mysql --version mysql Ver 15.1 Distrib 10.6.22-MariaDB

• Secure the database:

sudo mysql_secure_installation

• Install Nginx:

sudo apt install nginx -y

• Check Nginx version:

nginx -v nginx/1.18.0 (Ubuntu)

• Start and enable Nginx:

sudo systemctl start nginx sudo systemctl enable nginx

• Install NVM (Node Version Manager):

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

• Reload terminal:

source ~/.bashrc

• Install Node.js version v20.19.4:

nvm install 20.19.4 nvm use 20.19.4 nvm alias default 20.19.4

• Verify Node and npm:

node -v v20.19.4 npm -v 10.8.2

• Install PM2 globally:

npm install -g pm2

• Login to MariaDB:

sudo mysql

• Create database and user:

CREATE DATABASE groot; CREATE USER 'groot_user'@'localhost' IDENTIFIED BY 'StrongPassword@123'; GRANT ALL PRIVILEGES ON groot.* TO 'groot_user'@'localhost'; FLUSH PRIVILEGES;

• Navigate to project directory:

cd /home/ubuntu/backend

• Setup and configure the .env file:

mv .env.example .env

• Edit the .env file and update database, server, and app settings.

• Install project dependencies:

npm install

• Notification Setup (Firebase)
• Go to Firebase Console → Project Settings → Service Accounts.
• Click Generate new private key and download the JSON file.
• Upload the downloaded file to the backend config folder:

/home/ubuntu/backend/config

• Rename the downloaded file to firebase.json:

mv firebase-adminsdk-xxxxx.json firebase.json

• Start backend using PM2:

pm2 start index.js --name groot pm2 save pm2 startup

• Restart backend after Firebase setup:

pm2 restart groot

• All steps are performed using Terminal (SSH).
• Create a new Nginx configuration file for your domain:

sudo nano /etc/nginx/sites-available/grootdemo.yourdworld.com

• Paste the following configuration (WITHOUT SSL):

            server {
                listen 80;
                server_name grootdemo.yourdworld.com;

                location / {
                    proxy_pass http://127.0.0.1:3000;
                    proxy_http_version 1.1;

                    proxy_set_header Upgrade $http_upgrade;
                    proxy_set_header Connection "Upgrade"; 
                    proxy_set_header Host $host;
                    proxy_set_header X-Real-IP $remote_addr;
                    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
                }

                access_log /var/log/nginx/grootdemo.yourdworld.com.access.log;
                error_log /var/log/nginx/grootdemo.yourdworld.com.error.log;
            }
    

• Enable the site:

sudo ln -s /etc/nginx/sites-available/grootdemo.yourdworld.com /etc/nginx/sites-enabled/

• Test Nginx configuration:

sudo nginx -t

• Restart Nginx:

sudo systemctl restart nginx

• Verify your application is accessible at:

http://grootdemo.yourdworld.com

• Install Certbot and Nginx plugin:

sudo apt update sudo apt install certbot python3-certbot-nginx -y

• Generate SSL certificate for your domain:

sudo certbot --nginx -d grootdemo.yourdworld.com

• During installation:
• Select option to redirect HTTP to HTTPS
• Provide email address for renewal notifications

• Certbot will automatically update your Nginx config to:
• Add SSL certificates
• Enable HTTPS (443)
• Redirect HTTP → HTTPS

• Verify SSL auto-renewal:

sudo certbot renew --dry-run

• Final access URL:

https://grootdemo.yourdworld.com

• Open Admin Code in Vs studio code
• Rename .env.example to .env
• Edit env file in admin
• update backend url to https://grootdemo.yourdworld.com

• install Node modules

npm i

• Create production build:

npm run build

• Upload build files into backend admin directory.
• Access admin panel via configured domain.

• PORT: The port number where your Node.js project runs. Commonly, 3000 or 5000.
• TOKEN_KEY: A secret key used for JWT encryption and authentication for API requests.
• DATABASE_HOST: The SQL database hostname. Usually set to "localhost" for local development.
• DATABASE_NAME: The name of your SQL database.
• DATABASE_USERNAME: The username required to access your database.
• DATABASE_PORT: The port number for your database. Typically set to 3306 for MySQL/MariaDB.
• DATABASE_PASSWORD: The password associated with your database username.
• BACKEND_URL: The URL of your backend server, which your frontend or other services will connect to.