Deploy Laravel App on DigitalOcean with Ploi

In this article, we'll explore how to deploy a Laravel app on DigitalOcean while managing the server with a tool called Ploi. DigitalOcean is a popular server provider for hosting web applications, and Ploi is a server management tool that simplifies the process. Ploi serves as an affordable alternative to Laravel Forge, boasting a range of additional features.

Digital ocean Ploi

Step 1: Create a DigitalOcean Account

  • Action: Sign up for a DigitalOcean account.
  • Benefit: Using the provided link grants you a free $200 credit for server usage.
  • Note: Generate an API token. This will be used to connect your Ploi account to DigitalOcean. You can find the API page on the left sidebar. Refrain from creating any servers at this stage; we'll handle that through Ploi.

Step 2: Generate DigitalOcean API Token

  1. Click on "Generate new Token".
  2. Input a token name.
  3. Set an expiration date.
  4. Allow write access.

DigitalOcean API Token Image

Step 3: Create a Ploi Account

  • Action: Register for a Ploi account.
  • Benefit: The provided link includes a 5-day free trial.
  • Note: The initial page on Ploi will guide you through the setup process. If you miss it, the subsequent steps will cover the setup in detail.

Step 4: Set Up Your Ploi Account

Add a Git Provider

Add a Server Provider

Create Your Server

  1. Since we've added our DigitalOcean token to Ploi, it can create and provision our server.
  2. On the create server page, select DigitalOcean as the provider.
  3. Choose your credentials. Ploi will suggest a name, but you can modify it.
  4. Use the default server settings. Ploi will use the latest Ubuntu version.
  5. For server type, select 'server' for a Laravel app. This includes NGINX, PHP, Memcached, supervisor, and a database. Learn more about server types.
  6. For the server plan, opt for the most affordable option. As of this writing, it's priced at $6.
  7. Choose a server region closest to your audience.
  8. Keep the web server settings at NGINX, PHP, and MySQL's latest versions.
  9. Decide whether to enable Ploi Monitoring.

Note: After creating the server, Ploi will notify you via email once it's ready.

Upgrade Your Plan

  • Action: Upgrade your plan on Ploi.
  • Recommendation: The Pro plan, priced at $16 (current rate), includes server monitoring, zero downtime deployment, and backups for MySQL and files.

Step 5: Create DNS Records on DigitalOcean

  1. Once Ploi finishes provisioning our server on DigitalOcean, navigate to the network tab in DigitalOcean. You can find this under Manage > Network.
  2. Add an A record pointing to the server Ploi set up for you.

DNS Image

  1. If using a subdomain for your Laravel project, add an 'api' hostname in the DNS and direct it to the Ploi-created server.

Subdomain Image


Read also : Debugging Laravel Sanctum SPA Authentication Issues.


  1. Update your domain's nameservers to:
    • ns1.digitalocean.com
    • ns2.digitalocean.com
    • ns3.digitalocean.com

Step 6: More Server Configuration

Enable OpCache

  • Location: Servers > {server} > PHP.
  • Benefit: OPcache boosts PHP performance by storing precompiled script bytecode in shared memory. This eliminates the need for PHP to load and parse scripts for every request. Ensure you reload the PHP FPM worker post-deployment to clear cache memory.
  • Note: Ploi includes this line in the site deploy script: echo "" | sudo -S service php8.2-fpm reload.

Database

  1. Create a new database for the application at Servers > {server} > Databases.
  2. You can also create a new user for the database or use the one Ploi created and emailed to you.
  3. Install PhpMyAdmin with a 1-click install at Servers > {server} > manage > services.

Scripts

  • Action: Create a new script in the scripts tab of the server and add the provided code.
  • Purpose: This script will be used when deploying Laravel apps. ¬†
cd {SITE_DIRECTORY}
git pull origin {BRANCH}
composer install --no-interaction --prefer-dist --optimize-autoloader
echo "" | sudo -S service php8.2-fpm reload

php artisan config:cache
php artisan route:cache
php artisan view:cache
php artisan event:cache
php artisan queue:restart

echo "ūüöÄ Application deployed!"

 

Step 7: Create Laravel Site

  1. Navigate to Ploi's site creation page.
  2. Select the server for your site.
  3. Add your domain name.
  4. In advanced settings, set the project type to Laravel.
  5. Opt for 'Create staging' if you need a staging environment. Remember to also set up a staging database.
  6. In the general tab, add a repository and select the script we added in Step 6 as the deploy script.
  7. Add SSL for the domain in the SSL tab. Learn more about SSL on Ploi.

SSL Image

  1. If needed, add a cronJob in the CronJob tab. I prefer to run my scheduler from the cron tab and create multiple queue workers in my app/Console/Kernel.php. Instead of creating multiple queues in the Queue under the Sites section.
  2. Access Laravel-specific actions from the Laravel tab.
  3. Enable zero downtime deployment at Sites > {example.com} > settings.
  4. Enable quick deploy Sites > {example.com} > Repository.
  5. Access 'Deploy webhook URL' at Sites > {example.com} > general. This webhook URL can be used to synchronize staging to production. Send a POST request to this URL to make synchronizing easier, so you don't have to visit Ploi each time. 
  6. To access Deployments & rollback, go to Sites > {example.com} > general.

Notes:

  • If you've set up a staging environment, remove 'config.php',¬†add '.log' from the 'ignored files & folder' section in the production tab of the staging site.
  • Add the subdomain of the staging site in DNS records on DigitalOcean and point it to the server IP address.
  • To login with SSH, read this article by Ploi on SSH
  • Some of the actions you can't find in the production website, will be in the staging. Example Deployments and rollback
  • If your server is not pointed to the current git commit, Disable 'Zero downtime deployment'. Push a commit and check if is reflected by¬†¬†SSH into the server and run¬†git show HEAD¬†in the site/staging directory, to know the commit being used by the server. You can enable¬†'Zero downtime deployment', when you confirm that latest changes is being reflected.
  • You may not need¬†'Zero downtime deployment', when you have a staging environement.¬†Since all the production does is copy the files from staging and this does not take time.

I hope this guide helps you deploy your Laravel app on DigitalOcean using Ploi. 


Read also : Step by step guide on how to get into Cyber Security on your own.