Versions and Tools Used

• Amazon Linux 2023
• Laravel 11
• PHP 8.3
• Node.js LTS
• Apache 2.4
• AWS EC2
• AWS RDS

Launch the EC2 Instance

Go to the AWS console and type “EC2” in the top-left search bar.

Press the orange "Launch Instance" button on the upper right of the dashboard.

Input Settings

(These are the values used in this setup)

• Name: Any (e.g., laravel-deploy)
• Amazon Machine Image: Amazon Linux 2023 AMI
• Instance Type: t2.micro (Free Tier)
• Key Pair: Leave blank
• Security Group: Create a new security group, allow SSH traffic (my IP), allow HTTPS traffic, and allow HTTP traffic
• Storage: 8GiB gp3
• No other changes

Click the "Launch Instance" button.

A key pair creation modal will appear: select "Create a new key pair" and set the name to any desired name (e.g., laravel-deploy). Then, press "Launch Instance" again.

The instance will now start.

Notes

The key pair is not required for the method below.

If connecting to EC2 via your PC terminal, you’ll need the key pair, but it’s not required if you use Instance Connect.

Using EC2 Instance Connect

Allow IP for Instance Connect

To enable command-line access to EC2, configure permissions for EC2 Instance Connect.

Edit the inbound rules.

1. Type: SSH
2. IP: 3.112.23.0/29
3. Port Range: 22

Note: The IP may vary by region. This setup uses the Tokyo region.

Connect with Instance Connect

On the EC2 dashboard, press the "Connect" button.

On the leftmost tab, select "EC2 Instance Connect," then press the orange "Connect" button.

If successful, you should see a screen like the one below.

Install Required Packages via Command Line

sudo dnf update -y
sudo dnf install -y php8.3
php -v
sudo dnf install -y php-mysqlnd

curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer
composer -V

sudo dnf install -y git
git -v

sudo dnf -y localinstall https://dev.mysql.com/get/mysql80-community-release-el9-1.noarch.rpm
sudo dnf -y install mariadb105

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

These commands install:

• PHP
• Composer
• Git
• MySQL
• Node.js

Note that MySQL is set up only to connect to an RDS server, so mysql -v or similar commands will return errors.

Clone from GitHub Repository

Operations on EC2

cd ~/.ssh
ssh-keygen -t rsa -b 4096

When prompted:

1. Press Enter to skip
2. Enter a password of choice (e.g., password)
3. Confirm the same password

This generates two keys. Copy the contents of the public key with the following command:

cat id_rsa.pub

Operations on GitHub

Navigate to your repository page.

Go to:

1. Settings
2. Deploy keys
3. Add deploy key

• Title: Any (e.g., EC2)
• Key: Paste the public key
• Press "Add Key" to save

Return to EC2 and Connect

ssh -T git@github.com

When prompted:

1. Enter "yes"
2. Enter the password you set during key generation

Clone the Repository

cd /var/www/html
sudo chmod 0777 /var/www/html
git clone URL

Replace URL with your repository clone URL:

Modifying Apache Settings

Create a Backup for Safety

sudo cp /etc/httpd/conf/httpd.conf /etc/httpd/conf/httpd.conf.backup20241111

Edit Configuration File Using vim Command

sudo vim /etc/httpd/conf/httpd.conf

Edit the Following Three Lines

Around line 119:

DocumentRoot "/var/www/html"
↓
DocumentRoot "/var/www/html/your-laravel-project-name/public"

Around line 131:

<Directory "/var/www/html">
↓
<Directory "/var/www/html/your-laravel-project-name/public">

Around line 151:

AllowOverride None
↓
AllowOverride All

After making the changes, restart Apache to apply them:

sudo systemctl restart httpd

Laravel Project Setup

Move to your project directory and enter the following commands:

cd laravel-docker
sudo cp .env.example .env
composer install
sudo chmod -R 777 storage
sudo chmod 777 .env
php artisan key:generate

At this point, connecting to the public IP might result in a database-related error.

Connecting to the Database Server and Creating a Database

Create a New Database in AWS RDS

In the AWS Management Console:

1. Go to RDS.
2. Select "Create Database."

In the database creation screen, modify the following:

1. Standard Create
2. MySQL
3. Free Tier
4. DB Instance: Use the free-tier micro instance.
5. DB Instance Identifier: Your choice (e.g., laravel-deploy)
6. Master Password: Your choice (e.g., password)
7. Confirm Password: Same as above (e.g., password)

After setup, copy the RDS Endpoint displayed in the management console.

Create the Database on EC2

Use the mysql command to connect to the RDS database server you created:

mysql -h laravel-deploy.c0l60w30treo.ap-northeast-1.rds.amazonaws.com -P 3306 -u admin -p

Replace laravel-deploy.c0l60w30treo.ap-northeast-1.rds.amazonaws.com with your RDS Endpoint. admin is your master username.

Once connected:

CREATE DATABASE laravel_deploy;
show databases;

The database named laravel_deploy has been created.

Update the .env File for Laravel Project

sudo vim .env

DB_CONNECTION=mysql
DB_HOST=laravel-deploy.c0l60w30treo.ap-northeast-1.rds.amazonaws.com
DB_PORT=3306
DB_DATABASE=laravel_deploy
DB_USERNAME=admin
DB_PASSWORD=password

DB_HOST: Your RDS Endpoint

DB_DATABASE: The name of the database created with CREATE DATABASE

DB_USERNAME and DB_PASSWORD: The master username and password.

Run the migration command to ensure everything is connected:

php artisan migrate

The database connection is now complete.

If you're using Vite, run the following commands as needed:

npm install
npm run build

Summary

This guide covered deploying a Laravel project on Amazon Linux 2023.

If any steps are unclear, feel free to check the video or leave a comment for further clarification.

References

Tutorial: Setting Up Node.js on an Amazon EC2 Instance