Deploy Laravel Application to Amazon EC2 Instance

Deploy Laravel Application to Amazon EC2 Instance

A beginner-friendly step-by-step guide to deploying Laravel application to Amazon EC2 instance. This process works for Node.js apps and lots of others

Everyone loves to deploy their applications to the Amazon EC2 instance. It's easy to deploy and maintain. This tutorial will launch a Laravel application to an EC2 instance.

What is EC2?

Amazon Elastic Compute Cloud (EC2) is one of the first offerings of Amazon Web Services (AWS). It's a computing service, and you can virtually launch applications of any size securely and reliably.

Prerequisites

  1. You need a Laravel application. If you don't have one, you can use this example app to deploy.

P.S.: You don't need a Laravel app; you can use any application of your choice. Ideas are the same; just a few deployment steps are different.

So, what are you waiting for? Let's go ahead and deploy your app to an EC2 instance. ☁️

Create Key Pairs

  1. Login to AWS Management Console, and select the correct region from the top-right corner:

  2. Now, go to EC2 Console, and click on the Key Pairs button under Network & Security:

  3. Click on Create key pairs from the top-right corner:

  4. Give it a name and click Create key pairs. It will download the keypair file and keep it in a safe place for later.

Launch an EC2 Instance

  1. Now, go to the instances page by clicking Instances under Instances:

  2. Click the Lunch instance button from the top-right corner:

  3. Now you are on the Lunch instance page:

    A. Give your instance a name
    B. Select Ubuntu
    C. Select "Ubuntu Server 22.04 LTS" AMI

  4. In the next section:

    D. Select the instance type; I selected a free-tier eligible "t2.micro".
    E. Select the key pairs you selected previously.

  5. Select all of these three checkboxes:

  6. Keep everything else as it is and click on the Lunch instance button from the right sidebar's summary widget:

  7. And then click the View all instances button:

  8. Wait until Status checks turn 2/2 checks passed and copy public_ip in a safe place:

Connect to the instance via SSH

  1. Change permission of your key file

     chmod 400 my_keypairs.pem
    
  2. Run this command by replacing <ip_address> to your instance's public IP address, you have copied before:

     ssh -i "my_keypairs.pem" ubuntu@<ip_address>
    
  3. Enter yes, if you are asked to save your IP to known hosts list. You should be logged in to the instance.

Launch your Laravel app

  1. Install some required packages

     sudo apt-get update
     sudo apt install curl git unzip -y
    
  2. Let's install PHP 8.1 and its required package to launch the app

     sudo apt install software-properties-common -y
     sudo add-apt-repository ppa:ondrej/php -y
     sudo apt install -y php8.1-fpm \
         php8.1-cli \ 
         php8.1-mysql \ 
         php8.1-curl \ 
         php8.1-xml \ 
         php8.1-mbstring
    

    Check the version by using php --version command:

  3. Install composer

     # Download the bin file
     curl -sS https://getcomposer.org/installer | php
     # Move it to correct path
     sudo mv composer.phar /usr/local/bin/composer
     # Make it executeable
     sudo chmod +x /usr/local/bin/composer
    
  4. Install Nginx

     sudo apt install nginx -y
    
  5. Clone your git repository link to an app directory. Replace the value of GIT_REPO and APP_DIR value. Then, run the command.

     # Replace values of these variables with yours
     GIT_REPO=https://github.com/HarunRay/laravel-to-lightsail.git
     APP_DIR=laravel-app
     # go to www directory
     cd /var/www/html
     # clone the git repo
     sudo git clone "$GIT_REPO" "$APP_DIR"
     # go to application directory
     cd "$APP_DIR"
     # copy .env.example file
     cp .env.example .env
     # Install dependencies
     sudo composer install
    
  6. Create Nginx config file:

     sudo vim /etc/nginx/sites-available/laravel
    

    Paste this code. Change 52.201.59.133 to your IP address and save.

     server {
      listen 80;
      listen [::]:80;
      server_name 52.201.59.133;
      root /var/www/html/laravel-ap/public;
    
      add_header X-Frame-Options "SAMEORIGIN";
      add_header X-Content-Type-Options "nosniff";
    
      index index.php;
    
      charset utf-8;
    
      location / {
          try_files $uri $uri/ /index.php?$query_string;
      }
    
      location = /favicon.ico { access_log off; log_not_found off; }
      location = /robots.txt  { access_log off; log_not_found off; }
    
      error_page 404 /index.php;
    
      location ~ \.php$ {
          fastcgi_pass unix:/var/run/php/php8.1-fpm.sock;
          fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
          include fastcgi_params;
      }
    
      location ~ /\.(?!well-known).* {
          deny all;
      }
     }
    

    Exit the Vim editor by pressing esc and then :wq . Then run this command:

     # link nginx config 
     sudo ln -s /etc/nginx/sites-available/laravel /etc/nginx/sites-enabled/
     sudo systemctl start nginx
     sudo systemctl enable nginx
    
  7. Set permission for your Laravel app:

     # Go to your laravel app directory
     cd /var/www/html/laravel-app/
     # Add files & folder www-data user & group
     sudo chown -R www-data:www-data .
     # Add your ubuntu to group
     sudo usermod -a -G www-data ubuntu
     # Set file(s) permission
     sudo find . -type f -exec chmod 644 {} \;
     # Set folder(s) permission
     sudo find . -type d -exec chmod 755 {} \;
     # Set cache directory permission
     sudo chgrp -R www-data storage bootstrap/cache
     sudo chmod -R ug+rwx storage bootstrap/cache
    
  8. Now, generate app key:

     sudo php artisan key:generate
    
  9. Open .env file to update:

     sudo vim /var/www/html/laravel-app/.env
    

    Now, change these values:

     APP_ENV=production
     # Change IP to yours
     APP_URL=http://52.201.59.133
    

    Exit the Vim editor by pressing esc and the :wq .

  10. Restart Nginx service

    sudo service nginx restart
    

    Now, type your public_ip to browser and hit enter. You should see the welcome page. 🚀

...

Conclusion

This article covers the very basic things about launching an instance. If you have any query or you are stuck, feel free to ask in the comment.

If you want to appreciate my work, love ❤️ this post, share it with your friends, subscribe to the newsletter, and follow me here on Hashnode.

I'm searching for the next topic to cover in this blog; if you have an idea, tweet me. Don't forget to follow me on Twitter, I regularly tweet about AWS, Laravel, Cloud, PHP, and various other Software Engineering topics.

Did you find this article valuable?

Support Harun's Blog - AWS, DevOps, Laravel by becoming a sponsor. Any amount is appreciated!