X
    Categories Tutorials

Install Laravel on Ubuntu 16.04

Installing Laravel on Ubuntu 16.04 is an easy task, just follow the steps bellow and you should have your Laravel installation on Ubuntu 16.04 ready in few minutes. 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.

A superb inversion of control container, expressive migration system, and tightly integrated unit testing support give you the tools you need to build any application with which you are tasked.

In this article we will show you how to install Laravel on a Ubuntu 16.04

We will be using our SSD 1 Linux VPS hosting plan for this tutorial.

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

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

3. INSTALL COMPOSER

Install Composer which is a tool for dependency management in PHP.

# curl -sS https://getcomposer.org/installer | php

Once 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.

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/

5. START LARAVEL

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.

Stuck somewhere? Get a VPS from us and we’ll do all of this for you, free of charge!

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 your Ubuntu 16.04 VPS. For more information about Laravel, you should check their official documentation.


Of course you don’t have to install Laravel on your Ubuntu 16.04 server, 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.

PS. If you liked this post please share it with your friends on the social networks using the buttons on the left or simply leave a reply below. Thanks.

admin :

View Comments (18)

  • Hi,

    Got Laravel installed quickly with your tutorial. I managed to get it running on VirtualBox. The official Laravel doc is ok but needs a lot of reading for something so simple.

    Thank you.

    • No need to edit the /etc/hosts file. If you have a domain name you can point it to your server IP address and add it to your Apache virtual host file.

      Thanks.

  • Please help:
    I did this: service apache2 reload
    and got below error:
    Job for apache2.service failed because the control process exited with error code. See "systemctl status apache2.service" and "journalctl -xe" for details.

    • There is an error in your Apache configuration and you can use systemctl status apache2.service or journalctl -xe to get more details about the problem.

      Thanks.

  • Great Tutorial. My virtual machine on which Ubuntu 16.04 is installed is on Azure cloud. When I type my domain name, I get the following displayed on the browser. What could be the reason here?

    */ define('LARAVEL_START', microtime(true)); /* |-------------------------------------------------------------------------- | Register The Auto Loader |-------------------------------------------------------------------------- | | Composer provides a convenient, automatically generated class loader for | our application. We just need to utilize it! We'll simply require it | into the script here so that we don't have to worry about manual | loading any of our classes later on. It feels great to relax. | */ require __DIR__.'/../vendor/autoload.php'; /* |-------------------------------------------------------------------------- | Turn On The Lights |-------------------------------------------------------------------------- | | We need to illuminate PHP development, so let us turn on the lights. | This bootstraps the framework and gets it ready for use, then it | will load up this application so that we can run it and send | the responses back to the browser and delight our users. | */ $app = require_once __DIR__.'/../bootstrap/app.php'; /* |-------------------------------------------------------------------------- | Run The Application |-------------------------------------------------------------------------- | | Once we have the application, we can handle the incoming request | through the kernel, and send the associated response back to | the client's browser allowing them to enjoy the creative | and wonderful application we have prepared for them. | */ $kernel = $app->make(Illuminate\Contracts\Http\Kernel::class); $response = $kernel->handle( $request = Illuminate\Http\Request::capture() ); $response->send(); $kernel->terminate($request, $response);

    • Shakti did you manage to solve your problem? I have the same problem and php 7.0.27 is installed.
      I got this error only when i point the DocumentRoot to /var/www/html/laravel/public for my virtualhost.

    • Do you have PHP installed on your server? Looks like the web server is failing to execute the PHP files.

  • Thank you, it works perfectly. But I can not access my previous project file (.php) anymore, whenever I type localhost it redirect to laravel framework. How to solve this? Please help.

    • Most likely you have your other project installed in a different directory. Check your web server (Apache/Nginx) settings.

  • Hi, i follow your step but error when run "php artisan key:generate" :

    PHP Warning: require(/var/www/html/web/vendor/autoload.php): failed to open stream: No such file or directory in /var/www/html/web/artisan on line 18
    PHP Fatal error: require(): Failed opening required '/var/www/html/web/vendor/autoload.php' (include_path='.:/usr/share/php') in /var/www/html/web/artisan on line 18

    i dont get vendor folder, any solution ?

    • Our tutorial is tested and working without a problem. Have you made sure that you’ve followed the instructions correctly?
      Please try doing all of the described steps again and be more careful.

  • Great tutorial to successfully install laraval... but i need info regarding can i use another url for laraval instead localhost..