One-Click Installation

SuiteCRM 8.x Initialization:

Overview:

This guide will walk you through initializing SuiteCRM 8.10.2 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)
• Open ports 22, 80 and 443 in the security group.
• 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:

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. It typically takes two to four minutes: the application is downloaded, then SuiteCRM installs itself and creates your administrator account before the site is served. The script generates new credentials for this instance.

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 your administrator login.
• Write the password down. It is generated for this instance and is not stored anywhere you can read it back.

2. Access the Web Interface:

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

• You will be greeted by the login screen.

3. Login:

• Log in with the username CRMadmin and the password shown in the summary.
• SuiteCRM will offer a short welcome wizard to set your name, locale and time zone. You can complete it or choose Start Using SuiteCRM to go straight to the dashboard.
• Change the administrator password under your user profile once you are in.

Step 3: Add Your Own Domain and SSL

• Your CRM is served over plain HTTP until you associate a domain. To use your own domain name with a free SSL certificate, run:

• Full instructions are in Associating Your Domain.

Important Notes:

• Outgoing Email:
  This instance does not send email until you configure an outgoing mail server under Admin, Email Settings. Until then, password resets and notifications will not arrive.
• 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.
• The scheduler is already running.
  Workflows, inbound email checks, reminders and scheduled reports run automatically inside the application container. You do not need to add anything to a crontab.