{"id":14873,"date":"2023-06-02T07:43:15","date_gmt":"2023-06-02T06:43:15","guid":{"rendered":"https:\/\/www.milesweb.co.uk\/hosting-faqs\/?p=14873"},"modified":"2024-08-02T09:32:27","modified_gmt":"2024-08-02T08:32:27","slug":"deploy-laravel-application-on-vps","status":"publish","type":"post","link":"https:\/\/www.milesweb.co.uk\/hosting-faqs\/deploy-laravel-application-on-vps\/","title":{"rendered":"Step-By-Step Guide to Deploying Laravel Applications on Virtual Private Servers"},"content":{"rendered":"\n

Laravel is a PHP framework<\/a> for creating websites and applications. And to host them, users require Laravel web hosting<\/a> infrastructure because, only in this way can they make web projects accessible worldwide. Laravel framework allows the development of mission-critical web projects that meet enterprise hosting requirements.<\/p>\n\n\n\n

MilesWeb has dedicated hosting and VPS hosting services for such crucial web projects. After all, we want a robust web hosting infrastructure that helps scale websites and applications. Our VPS hosting services comprise unmetered bandwidth, a 1 Gbps network, SSD NVMe storage and 28 data centers location.<\/p>\n\n\n\n

We offer managed VPS hosting services. If you want your Laravel projects to be hosted on our Virtual Private Servers, we can assist you with managed plans! However, if you are satisfied with unmanaged web hosting plans, here is the step by step guide to answer ‘How to Run a Laravel Project?’ on Virtual Private Servers.<\/p>\n\n\n\n

Prior Requirements<\/h2>\n\n\n\n

Referring to the above information, we assume that you have the prior technical expertise to manage virtual private servers. You must know Linux command lines with an Ubuntu operating system. Once you are able to conduct all relevant tasks on the command terminal, underlying steps will help you know ‘how to run a Laravel project’ on VPS.<\/p>\n\n\n\n

Steps to Follow to Run Laravel Project On VPS<\/h2>\n\n\n\n

1. Server’s Provisioning<\/h3>\n\n\n\n

First, you must set up a virtual private server to run the Laravel project on it. Then, SSH (Secure Shell) protocol is required to initiate the setup. This protocol lets users connect to a remote server using a password or key pair. Below is the command to generate new key pairs on machines.<\/p>\n\n\n\n

ssh-keygen -t rsa<\/p>\n\n\n\n

You should be familiar with the Terminal and how to operate Unix-like OSes in general before starting. These command line codes should work on any Linux distribution of VPS that uses the standard Terminal syntax.<\/p>\n\n\n\n

Update the package list:<\/strong> Run the following command to update the package list on your VPS:<\/p>\n\n\n\n

sudo apt-get update && sudo apt-get upgrade<\/p>\n\n\n\n

Now you can install PHP. It is straightforward and effortless to do so.<\/p>\n\n\n\n

sudo apt-get install php<\/p>\n\n\n\n

PHP and several extensions will be installed along with the latest version of PHP. This code will tell you what version you have.<\/p>\n\n\n\n

php \u2013v<\/p>\n\n\n\n

If you want to install PHP 7.4, how do you do it? It is necessary to use a PPA, or a Personal Package Archive, created by Ond\u0159ej Sur\u00fd. Installing older PHP versions this way is safe. One by one, run these three commands:<\/p>\n\n\n\n

sudo apt install software-properties-common<\/p>\n\n\n\n

sudo add-apt-repository ppa:ondrej\/php<\/p>\n\n\n\n

sudo apt-get update<\/p>\n\n\n\n

Now that PHP 8.0 is recognized by your system, run the following command:<\/p>\n\n\n\n

sudo apt install php8.0<\/p>\n\n\n\n

Any PHP version can be substituted for this number.<\/p>\n\n\n\n

2. VPS Provisioning<\/h3>\n\n\n\n

Add our VPS hosting plans to the cart and include all relevant add-on features like backup, DDoS protection, website backup and others. After that, you will get all log in credentials to access the server and its databases.<\/p>\n\n\n\n

Set up Composer<\/h4>\n\n\n\n

Here are the steps for setting up a composer.<\/p>\n\n\n\n

$ cd ~<\/p>\n\n\n\n

$ mkdir bin<\/p>\n\n\n\n

$ cd bin<\/p>\n\n\n\n

$ curl -sS https:\/\/getcomposer.org\/installer | php<\/p>\n\n\n\n

<\/a>Set up Envoy<\/h4>\n\n\n\n

\/\/ Envoy.blade.php<\/p>\n\n\n\n

@setup<\/p>\n\n\n\n

    $branch = isset($branch) ? $branch : “master”;<\/p>\n\n\n\n

    $serverUser = ‘deployer’;<\/p>\n\n\n\n

    $rootDirectory = ‘~\/home\/’ . $serverUser;<\/p>\n\n\n\n

    $server = $serverUser . ‘@server_ip’;<\/p>\n\n\n\n

@endsetup<\/p>\n\n\n\n

@servers([‘production’ => $server])<\/p>\n\n\n\n

@task(‘clone’, [‘on’ => ‘production’])<\/p>\n\n\n\n

    echo ‘>> cd {{ $rootDirectory }}’<\/p>\n\n\n\n

    cd {{ $rootDirectory }}<\/p>\n\n\n\n

    echo ‘>> mkdir {{ $rootDirectory }}\/project’<\/p>\n\n\n\n

    mkdir {{ $rootDirectory }}\/project<\/p>\n\n\n\n

    echo ‘>> chmod 755 {{ $rootDirectory }}\/project’<\/p>\n\n\n\n

    chmod 755 {{ $rootDirectory }}\/project<\/p>\n\n\n\n

    echo ‘>> cd {{ $rootDirectory }}\/project’<\/p>\n\n\n\n

    cd {{ $rootDirectory }}\/project<\/p>\n\n\n\n

    echo ‘<< git clone git@github.com:username\/project.git deploy’<\/p>\n\n\n\n

    git clone git@github.com:username\/project.git deploy<\/p>\n\n\n\n

@endtask<\/p>\n\n\n\n

@task(‘environment’, [‘on’ => ‘production’])<\/p>\n\n\n\n

    echo ‘>> cd {{ $rootDirectory }}\/project\/deploy’<\/p>\n\n\n\n

    cd {{ $rootDirectory }}\/project\/deploy<\/p>\n\n\n\n

    echo ‘<< cp .env.example .env’<\/p>\n\n\n\n

    cp .env.example .env<\/p>\n\n\n\n

    echo ‘>> SSH to your server, paste your valid .env credentials & save them. Then run envoy run post-deploy’<\/p>\n\n\n\n

@endtask<\/p>\n\n\n\n

@task(‘composer-install’, [‘on’ => ‘production’])<\/p>\n\n\n\n

    echo ‘>> cd {{ $rootDirectory }}\/project\/deploy’<\/p>\n\n\n\n

    cd {{ $rootDirectory }}\/project\/deploy<\/p>\n\n\n\n

    echo ‘<< \/home\/{{ $serverUser }}\/bin\/composer.phar install –prefer-dist –no-scripts –no-dev -q -o’<\/p>\n\n\n\n

    \/home\/{{ $serverUser }}\/bin\/composer.phar install –prefer-dist –no-scripts –no-dev -q -o<\/p>\n\n\n\n

@endtask<\/p>\n\n\n\n

@task(‘composer-update’, [‘on’ => ‘production’])<\/p>\n\n\n\n

    echo ‘>> cd {{ $rootDirectory }}\/project\/deploy’<\/p>\n\n\n\n

    cd {{ $rootDirectory }}\/project\/deploy<\/p>\n\n\n\n

    echo ‘<< \/home\/{{ $serverUser }}\/bin\/composer.phar dump -o && php artisan optimize’<\/p>\n\n\n\n

    \/home\/{{ $serverUser }}\/bin\/composer.phar dump -o && php artisan optimize<\/p>\n\n\n\n

@endtask<\/p>\n\n\n\n

@task(‘migrate’, [‘on’ => ‘production’])<\/p>\n\n\n\n

    echo ‘>> cd {{ $rootDirectory }}\/project\/deploy’<\/p>\n\n\n\n

    cd {{ $rootDirectory }}\/project\/deploy<\/p>\n\n\n\n

    php artisan migrate –force;<\/p>\n\n\n\n

@endtask<\/p>\n\n\n\n

@task(‘symlink’, [‘on’ => ‘production’])<\/p>\n\n\n\n

    echo ‘<< ln -s \/home\/{{ $serverUser }}\/project\/deploy\/public \/var\/www\/html’<\/p>\n\n\n\n

    ln -s \/home\/{{ $serverUser }}\/project\/deploy\/public \/var\/www\/html<\/p>\n\n\n\n

@endtask<\/p>\n\n\n\n

@task(‘deploy-changes’, [‘on’ => ‘production’])<\/p>\n\n\n\n

    echo ‘>> cd {{ $rootDirectory }}\/project\/deploy’<\/p>\n\n\n\n

    cd {{ $rootDirectory }}\/project\/deploy<\/p>\n\n\n\n

    echo ‘>> git checkout {{ $branch }}’<\/p>\n\n\n\n

    git checkout {{ $branch }}<\/p>\n\n\n\n

    echo ‘<< git pull –rebase’<\/p>\n\n\n\n

    git pull –rebase<\/p>\n\n\n\n

@endtask<\/p>\n\n\n\n

@story(‘deploy’, [‘on’ => ‘production’])<\/p>\n\n\n\n

    setup<\/p>\n\n\n\n

    environment<\/p>\n\n\n\n

@endstory<\/p>\n\n\n\n

@story(‘post-deploy’, [‘on’ => ‘production’])<\/p>\n\n\n\n

    composer-install<\/p>\n\n\n\n

    composer-update<\/p>\n\n\n\n

    migrate<\/p>\n\n\n\n

    symlink<\/p>\n\n\n\n

@endstory<\/p>\n\n\n\n

@story(‘update’)<\/p>\n\n\n\n

    deploy-changes<\/p>\n\n\n\n

    composer-update<\/p>\n\n\n\n

    migrate<\/p>\n\n\n\n

@endstory<\/p>\n\n\n\n

<\/a>Deploy<\/h4>\n\n\n\n

During the initial launch phase of your application on the remote server, you will only need to run this task.<\/p>\n\n\n\n

$ envoy run deploy<\/p>\n\n\n\n

A message is displayed at the end of the initial task, informing the user that the .env file is being prepared.<\/p>\n\n\n\n

<\/a>Set up .env<\/h4>\n\n\n\n

Make sure that the .env configuration contains the necessary credentials for your application to run on the server. Copy and paste the .env file to the server where the .env file is located, and save it.<\/p>\n\n\n\n

<\/a>Final Deploy<\/h4>\n\n\n\n

Run another command after saving the server .env file.<\/p>\n\n\n\n

$ envoy run post-deploy<\/p>\n\n\n\n

<\/a>Finishing<\/h4>\n\n\n\n

You may be wondering if the deployment script could potentially cause your application to break and result in downtime during any of the deployments.<\/p>\n\n\n\n

3. Basic Setup Process<\/h3>\n\n\n\n

If your VPS server runs hassle-free, use SSH with an IP address to log in as a root user. You can check your IP address online. Here is an example of how can implement it:<\/p>\n\n\n\n

ssh root@104.248.157.172<\/p>\n\n\n\n

Logging in to the client using key pair is more secure than using a user id and password. Below is the command to add a new user to the terminal.<\/p>\n\n\n\n

adduser nonroot<\/p>\n\n\n\n

Execute this command in your server. Then, create a sudo group using the following command:<\/p>\n\n\n\n

usermod -aG sudo nonroot<\/p>\n\n\n\n

After deploying the basic setup, installing PHP and other required software on your server is time. Here are the rest of the steps that we will discuss.<\/p>\n\n\n\n

Step 2: Set up a VPS instance<\/h3>\n\n\n\n

Once you’ve chosen a provider, create a new VPS instance and choose an operating system (such as Ubuntu or CentOS) that supports PHP, MySQL, and other required software. Configure the server’s firewall, SSH access, and other security settings.<\/p>\n\n\n\n

Step 3: Install the necessary software<\/h3>\n\n\n\n

Next, install the necessary software on the server, such as PHP, MySQL, Nginx or Apache, and Composer. You can use package managers like apt or yum to install these packages automatically. Install Composer, a dependency manager for PHP, by running the following commands:<\/p>\n\n\n\n

curl -sS https:\/\/getcomposer.org\/installer | php<\/p>\n\n\n\n

sudo mv composer.phar \/usr\/local\/bin\/composer<\/p>\n\n\n\n