We’ll teach you how to install Laravel on Ubuntu 16.04. Laravel is a PHP web application framework which is intended for the development of web applications following the model–view–controller (MVC) architectural pattern. It has an expressive, elegant syntax and provides tools needed for large, robust applications. Installing Laravel on Ubuntu 16.04 is an easy task, just follow the steps below and you should have your Laravel installation on Ubuntu 16.04 ready in a few minutes.
To Install Laravel on Ubuntu 16.04, carefully follow the steps below:
Table of Contents
Step 1: Log In to Your Server via SSH
# ssh root@server_ip
You can check whether you have the proper Ubuntu version installed on your server with the following command:
# lsb_release -a
You should get this output:
Distributor ID: Ubuntu Description: Ubuntu 16.04.1 LTS Release: 16.04 Codename: xenial
Step 2: Update the System
Make sure your server is fully up to date using:
# apt update && apt upgrade
Then install some much-needed dependencies:
# apt install php-mcrypt php-gd php-mbstring
Step 3: Install Composer
Install Composer which is a tool for dependency management in PHP.
# curl -sS https://getcomposer.org/installer | php
Once the Composer is installed, you need to move it so that Composer can be available within your machine path:
# mv composer.phar /usr/local/bin/composer
Make it executable:
# chmod +x /usr/local/bin/composer
Now create a directory where Laravel will be downloaded.
# mkdir /var/www/html/your_website
Of course, replace your_website with your actual domain name or any name for that matter.
Step 4: Download the Latest Laravel Version
Now enter the newly created directory and download the latest Laravel version.
# cd /var/www/html/your_website # git clone https://github.com/laravel/laravel.git
Move the files and directories from the Github Laravel clone into your current working directory (/var/www/html/your_website/)
# mv laravel/* . # mv laravel/.* .
Now delete the unnecessary laravel dir:
# rmdir laravel/
Step 5: Start Laravel on Ubuntu 16.04
Start the Laravel installation using Composer:
# composer install
Once the installation is finished, assign the proper ownership over the Laravel files and directories:
# chown www-data: -R /var/www/html/your_website/
Next, set the encryption key needed:
# php artisan key:generate
You will notice the below error when running the command.
[ErrorException] file_get_contents(/var/www/html/your_website/.env): failed to open stream: No such file or directory
To solve this you should rename the .env.example file into .env:
# mv .env.example .env
Generate the encryption key again:
# php artisan key:generate
You should get the following output:
Application key [base64:ULQsledeS17HxCAsssA/06qN+aQGbXBPPpXVeZvdRWE=] set successfully.
Of course, the key will be different in your case. Now edit the app.php file and configure the encryption key. Open the file with your favorite text editor. We are using nano.
# nano config/app.php
Locate the ‘key’ => env(‘APP_KEY’ line and add the key next to it. After you are done the directive should look like this:
'key' => env('APP_KEY', 'base64:7fO0S9TxZu8M2NwBWVEQsjPGRi+D1t6Ws8i0Y2yW/vE='), 'cipher' => 'AES-256-CBC',
Save and close the file.
Step 6: Setup Apache Virtual Host
Create an Apache virtual host file so your domain can serve Laravel. Open a file, for example, your_website.conf:
# nano /etc/apache2/sites-available/your_website.conf
Paste the following:
<VirtualHost *:80> ServerAdmin admin@your_domain.com DocumentRoot /var/www/html/your_website/public/ ServerName your_domain.com ServerAlias www.your_domain.com <Directory /var/www/html/your_website/> Options FollowSymLinks AllowOverride All Order allow,deny allow from all </Directory> ErrorLog /var/log/apache2/your_domain.com-error_log CustomLog /var/log/apache2/your_domain.com-access_log common </VirtualHost>
Enable the site:
# a2ensite your_website.conf
Restart Apache so the changes can take effect:
# service apache2 reload
Now open your favorite web browser and navigate to http://your_domain.com where you will be welcomed by a page as shown in the image below:
Congratulations, you have successfully installed Laravel on Ubuntu 16.04. For more information about Laravel, you should check their official documentation.
Of course, you don’t have to install Laravel on Ubuntu 16.04, if you use one of our Laravel VPS Hosting services, in which case you can simply ask our expert Linux admins to install Laravel on Ubuntu 16.04 for you. They are available 24×7 and will take care of your request immediately. For an updated tutorial on how to install Laravel on Ubuntu 20.04, check it on our blog.
PS. If you liked this post, on how to install Laravel on Ubuntu 16.04, please share it with your friends on the social networks using the buttons on the left or simply leave a reply below. Thanks.