One-Click Installation

OrangeHRM Initialization:

Overview:

This guide will walk you through initializing OrangeHRM on your AWS instance in just one click. The setup process is streamlined using our custom script, designed for ease of use and efficiency. Before starting the script, ensure the minimum requirement is met.

Pro Tip: We recommend associating an AWS Elastic IP with your instance before running the setup. This prevents your IP address from changing when the instance is stopped and restarted.

Step 1: Access Your AWS Instance

1. Launch Your AWS EC2 Instance:

• Choose your desired AWS EC2 instance type. (Recommended: t3a.small / t3.small)
• Once the instance is running, connect to it via SSH.

2. Connect to the Instance:

• Open your terminal (Mac/Linux) or use an SSH client (e.g., PuTTY for Windows).
• Run the following SSH command:

• When prompted for the login, enter:
  

3. Run the Initialization Script:

• To initiate the installation, run the following command:

• Note: This script automates the entire installation process. While it runs, ensure your terminal remains active, and do not close the session. The script may take up to 10-20 seconds to complete. The script will random generate new credentials for all the necessity.

Step 2: Instance Set Up and Installation 

1. Completion Confirmation:

• Once the installation is finished, you will see a summary on the screen that includes all credentials.

2. Access the Web Interface:

• Open your web browser and navigate to http://<your-public-ip> :

• You will be greeted by the welcome screen.

Step 3: Finalizing Installation  

1. Welcome:

• Click Next to start.

2. License Acceptance:

• Check the “I accept …” box to agree to the terms and click Next to proceed.

3. Database Configuration:

• Select “Existing empty database” as our initialization script already created the database for you.
• Get the database credentials from the summary of initialization script earlier and fill up the configuration as below.

Server: localhost
Port: 3306
Username: dbadmin
Password: (the root credential generated in Step 1)
Database: orangehrmdb

• Check the “Enable Data Encryption“
• Once done, press ‘Next‘.

4. System Check:

• You shall see all requirement are ticked as we have pre-configured the instance for you. Click “Next” to go to next step.

5. Instance Creation:

• Fill up all fields accordingly as per your business needs. Click “Next” to proceed when done.

6. Admin User Creation:

• Fill up all fields accordingly as per your business needs.
• Take note of the Admin username and password as you will use them to log into Admin Panel.

7. Confirmation:

• Confirm all details on this screen. Click “Back” to edit them otherwise click “Install“.

8. Installation:

• If everything goes well, you will the progress bar reaching 100% as shown. Click Next.

9. Installation Complete:

• Once the installation is complete, you will see the final “Congratulations” screen as shown.
• Click “Launch OrangeHRM” to proceed to login.

10. OrangeHRM Dashboard:

• Use the Admin credentials you created earlier to login and OrangeHRM panel will be waiting for you. 

Important Notes:

• Mail Sending Blockage:
  AWS may have email-sending restrictions in place by default. Before using the instance for email sending, submit a request to AWS to lift the restriction on outbound email traffic.