How to Install Laravel 7 on Ubuntu 20.04 with Nginx and MariaDB

Updated on August 7, 2020
How to Install Laravel 7 on Ubuntu 20.04 with Nginx and MariaDB header image


Laravel is a framework for PHP to create web applications. This guide describes how to install Laravel on a freshly-deployed Ubuntu 20.04 LTS server instance.


1. Install Prerequisites

  1. Install the software dependencies.

     $ sudo apt install -y php-mbstring php-xml php-fpm php-zip php-common php-fpm php-cli unzip curl nginx
  2. Install Composer:

     $ sudo curl -s | php
     $ sudo mv composer.phar /usr/local/bin/composer
  3. Verify the Composer installation.

     $ composer diagnose
     Checking platform settings: OK
     Checking git settings: OK
     Checking http connectivity to packagist: OK
     Checking https connectivity to packagist: OK
     Checking rate limit: OK
     Checking disk free space: OK
     Checking pubkeys:
     Tags Public Key Fingerprint: 57815BA2 7E54DC31 7ECC7CC5 573090D0  87719BA6 8F3BB723 4E5D42D0 84A14642
     Dev Public Key Fingerprint: 4AC45767 E5EC2265 2F0C1167 CBBB8A2B  0C708369 153E328C AD90147D AFE50952
     Checking composer version: OK
     Composer version: 1.10.10
     PHP version: 7.4.3
     PHP binary path: /usr/bin/php7.4
     OpenSSL version: OpenSSL 1.1.1f  31 Mar 2020
  4. Install MariaDB.

     $ sudo apt install -y mariadb-client mariadb-server
  5. Start MariaDB.

     $ sudo systemctl enable --now mariadb.service
  6. The root password is blank for a newly installed MariaDB server. Configure the MariaDB security by answering these questions appropriately for your server.

     $ sudo mysql_secure_installation

2. Install Laravel

Replace example with your project name where it appears throughout this guide.

  1. Create a Laravel project with Composer. You may disregard the warning not to run Composer as root for this step. See the Composer documentation for details.

     $ cd /var/www/html
     $ sudo composer global require laravel/installer
     $ sudo composer create-project --prefer-dist laravel/laravel example
  2. Grant your non-root user access.

     $ sudo chmod -R 755 /var/www/html/example
     $ sudo chown -R example_user:example_user /var/www/html/example
  3. Install the example project.

     $ cd example
     $ composer install
  4. Test the Laravel application manually in the /var/www/html/example folder. Replace the example IP address with your server's IP.

     $ cd /var/www/html/example
     $ php artisan serve --host= --port=8000

    To access this example:

Type Ctrl+C in your SSH session to stop the Laravel application.

3. Configure Nginx

For public/production use, configure Nginx.

  1. Set the file permissions. Replace example with your Laravel project name.

     $ sudo chmod -R 755 /var/www/html/example
     $ sudo chown -R www-data:www-data /var/www/html/example
  2. Create an Nginx configuration file.

     $ sudo nano /etc/nginx/sites-available/example
  3. Paste the following to your example configuration file.

    • Replace server_name; with your domain or server IP address. You can also use an underscore as a wildcard, for example: server_name _;
    • Replace /var/www/html/example/public with your project path.

    If you installed a different version of PHP, edit the /var/run/php/php7.4-fpm.sock value for your version. You can find your sock file in /var/run/php/.

     server {
         listen 80;
         root /var/www/html/example/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; }
         error_page 404 /index.php;
         location ~ \.php$ {
             fastcgi_pass unix:/var/run/php/php7.4-fpm.sock;
             fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
             include fastcgi_params;
         location ~ /\.(?!well-known).* {
             deny all;
  4. Enable the Nginx configuration.

     $ sudo ln -s /etc/nginx/sites-available/example /etc/nginx/sites-enabled/
  5. Remove the default configuration file.

     $ sudo rm /etc/nginx/sites-enabled/default
  6. Restart Nginx.

     $ sudo systemctl restart nginx
  7. Test that your Laravel application loads properly in a web browser.

4. Configure MariaDB

  1. Log in to MariaDB as root.

     # mysql -p -u root
  2. Create a database named laravelexample.

     MariaDB [(none)]> CREATE DATABASE `laravelexample` CHARACTER SET utf8 COLLATE utf8_general_ci;
  3. Create a database user.

     MariaDB [(none)]> CREATE USER 'laravelexampleuser'@'%' IDENTIFIED BY 'password';
  4. Grant permissions.

     MariaDB [(none)]> use laravelexample;
     MariaDB [laravelexample]> GRANT ALL ON 'laravelexample'.* TO 'laravelexampleuser'@'%';
     MariaDB [laravelexample]> FLUSH PRIVILEGES;
     MariaDB [laravelexample]> EXIT;
  5. Edit the Laravel application .env file.

     $ sudo nano /var/www/html/example/.env

    Set the database connection variables.

  6. Save and exit the file.


You've set up a template Laravel application. See the official documentation for further information.