DEV Community

Cover image for Deploying Laravel with Nginx on Ubuntu 24.04
Vultr profile image Sanskriti Harmukh
Sanskriti Harmukh for Vultr

Posted on with Aashish Chaurasiya • Originally published at docs.vultr.com

Deploying Laravel with Nginx on Ubuntu 24.04

#php #laravel #nginx #linux

Laravel is a popular PHP framework with routing, authentication, and database management built in. This guide deploys a Laravel app behind Nginx on Ubuntu 24.04, wires it to MySQL, secures it with Let's Encrypt, and builds a small dashboard that queries live data.

Prerequisites: Ubuntu 24.04 with Nginx and MySQL installed, a non-root sudo user, a domain A record (e.g. app.example.com).

Create the Database 

$ sudo mysql
Enter fullscreen mode Exit fullscreen mode 
mysql> CREATE DATABASE laravel_demo;
mysql> CREATE USER 'laravel_user'@'localhost' IDENTIFIED WITH mysql_native_password BY 'secure_password';
mysql> GRANT ALL ON laravel_demo.* TO 'laravel_user'@'localhost';
mysql> FLUSH PRIVILEGES;
mysql> EXIT;
Enter fullscreen mode Exit fullscreen mode

Seed a demo table to query later:

$ mysql -u laravel_user -p
Enter fullscreen mode Exit fullscreen mode 
mysql> USE laravel_demo;
mysql> CREATE TABLE server_stats (
            id INT AUTO_INCREMENT,
            server_name VARCHAR(255),
            region VARCHAR(255),
            cpu_usage DECIMAL(5,2),
            memory_usage DECIMAL(5,2),
            status ENUM('active', 'maintenance', 'offline'),
            last_updated TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
            PRIMARY KEY(id)
        );
mysql> INSERT INTO server_stats (
           server_name, region, cpu_usage, memory_usage, status
       )
       VALUES
           ('app-01', 'us-east', 24.50, 45.30, 'active'),
           ('db-01',  'eu-west', 12.75, 78.20, 'active'),
           ('web-01', 'ap-south', 65.80, 89.50, 'active');
mysql> EXIT;
Enter fullscreen mode Exit fullscreen mode

Install Composer and PHP Extensions 

$ sudo apt update
$ sudo apt install composer php php-curl php-fpm php-bcmath php-json php-mysql php-mbstring php-xml php-tokenizer php-zip -y
$ composer --version
$ php --version
$ sudo systemctl restart php8.3-fpm
Enter fullscreen mode Exit fullscreen mode

php-fpm runs PHP as a service Nginx can talk to; php-mysql/php-mbstring/php-xml/php-tokenizer/php-zip cover Laravel's runtime requirements.

Create the Laravel Project 

$ cd ~
$ composer create-project --prefer-dist laravel/laravel laravel-demo
$ cd laravel-demo
$ php artisan key:generate
Enter fullscreen mode Exit fullscreen mode

Edit .env:

$ nano .env
Enter fullscreen mode Exit fullscreen mode 
APP_NAME=laravel-demo
APP_ENV=development
APP_KEY=base64:APPLICATION_UNIQUE_KEY
APP_DEBUG=true
APP_URL=http://app.example.com

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel_demo
DB_USERNAME=laravel_user
DB_PASSWORD=secure_password

SESSION_DRIVER=file
Enter fullscreen mode Exit fullscreen mode

Move it to the web root and set permissions:

$ sudo mv ~/laravel-demo /var/www/laravel-demo
$ sudo chown -R www-data:www-data /var/www/laravel-demo
$ sudo chmod -R 755 /var/www/laravel-demo/storage
$ sudo chmod -R 755 /var/www/laravel-demo/bootstrap/cache
$ cd /var/www/laravel-demo
$ php artisan migrate
Enter fullscreen mode Exit fullscreen mode

Configure Nginx 

$ sudo nano /etc/nginx/sites-available/laravel-demo.conf
Enter fullscreen mode Exit fullscreen mode 
server {
    listen 80;
    server_name app.example.com;
    root /var/www/laravel-demo/public;

    add_header X-Frame-Options "SAMEORIGIN";
    add_header X-XSS-Protection "1; mode=block";
    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; }

    location ~ \.php$ {
        fastcgi_pass unix:/var/run/php/php8.3-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
        include fastcgi_params;
    }

    location ~ /\.(?!well-known).* {
        deny all;
    }
}
Enter fullscreen mode Exit fullscreen mode 
$ sudo ln -s /etc/nginx/sites-available/laravel-demo.conf /etc/nginx/sites-enabled/
$ sudo nginx -t
$ sudo systemctl restart nginx
$ sudo ufw allow 80/tcp
$ sudo ufw reload
Enter fullscreen mode Exit fullscreen mode

Visit http://app.example.com — you should see the default Laravel welcome page.

Secure with Let's Encrypt 

$ sudo apt install certbot python3-certbot-nginx -y
$ sudo certbot --nginx --redirect -d app.example.com -m admin@app.example.com --agree-tos
$ sudo certbot renew --dry-run
$ sudo systemctl restart nginx
$ sudo ufw allow 443/tcp
$ sudo ufw reload
Enter fullscreen mode Exit fullscreen mode

Build a Demo Dashboard

Replace the default route to query server_stats and render it.

$ sudo mv /var/www/laravel-demo/routes/web.php /var/www/laravel-demo/routes/web.php.ORIG
$ sudo nano /var/www/laravel-demo/routes/web.php
Enter fullscreen mode Exit fullscreen mode 
<?php

use Illuminate\Support\Facades\DB;
use Illuminate\Support\Facades\Route;

Route::get('/', function () {
    $servers = DB::table('server_stats')
                ->orderBy('status')
                ->orderBy('cpu_usage', 'desc')
                ->get();

    return view('dashboard', ['servers' => $servers]);
});
Enter fullscreen mode Exit fullscreen mode

Create the Blade view:

$ sudo nano /var/www/laravel-demo/resources/views/dashboard.blade.php
Enter fullscreen mode Exit fullscreen mode 
<!DOCTYPE html>
<html>
<head>
    <title>Server Dashboard</title>
    <style>
        body { font-family: 'Segoe UI', sans-serif; margin: 2rem; }
        .server-card {
            padding: 1rem;
            margin-bottom: 1rem;
            border-radius: 8px;
            box-shadow: 0 2px 4px rgba(0,0,0,0.1);
        }
        .active {
            border-left: 4px solid #10B981;
            background: #F0FDF4;
        }
        .maintenance {
            border-left: 4px solid #F59E0B;
            background: #FFFBEB;
        }
        .offline {
            border-left: 4px solid #EF4444;
            background: #FEF2F2;
        }
        .metric {
            font-weight: 600;
            color: #1F2937;
        }
    </style>
</head>
<body>
    <h1>Server Status Dashboard</h1>
    <p>Live metrics from your infrastructure</p>

    @foreach($servers as $server)
    <div class="server-card {{ $server->status }}">
        <h3>{{ $server->server_name }} <small>({{ $server->region }})</small></h3>
        <p class="metric">Status: {{ ucfirst($server->status) }}</p>

        @if($server->status != 'offline')
            <p class="metric">CPU: {{ $server->cpu_usage }}%</p>
            <p class="metric">Memory: {{ $server->memory_usage }}%</p>
        @endif

        <p>Last updated: {{ $server->last_updated }}</p>
    </div>
    @endforeach
</body>
</html>
Enter fullscreen mode Exit fullscreen mode 
$ sudo systemctl restart nginx
Enter fullscreen mode Exit fullscreen mode

Visit https://app.example.com — the dashboard should render live rows from server_stats.

Next Steps

Laravel is deployed behind Nginx with TLS and a working database-backed view. From here:

  • Add Eloquent models and migrations instead of raw DB::table() queries for larger apps
  • Switch APP_ENV to production and APP_DEBUG to false before going live
  • Set up a queue worker (php artisan queue:work) as a systemd service for background jobs

For the full guide, visit the original article on Vultr Docs.

Top comments (0)