How to Deploy a Laravel App With the Debian 11 Vagrant Box

This article will serve as a guide for deploying a sample laravel app using the Debian 11 vagrant box. The vagrant box can be used as a testing ground before deploying your app to the cloud using a cloud provider such as AWS for your consumers to access the app you built. To get started, you will have to install vagrant on your local machine. If you are new to vagrant, you can check out this on how to set one up. article Once you’ve got your machine running, it’s time to install important packages and dependencies that are needed to get the app running in your vagrant box. It should be noted that the vagrant acts as our server. You can find some very important server requirements to deploy a laravel app . Also, the following packages will be needed in our vagrant box; here apache2 => A web server software to access our deployed app from the browser. git => A collaboration tool needed to get the app code from its online repository into our local machine. composer => A tool for dependency management in PHP. It is always good practice to create a user for a designated task in Linux. So we start by creating a user for this deployment. To create a user and its password and switch to that user, run this command below. sudo useradd -m -s /bin/bash -c "Laravel User" laravelUser # User Creation sudo passwd laravelUser # User password creation sudo usermod -aG sudo laravelUser # Add user to the sudo group su laravelUser. # Switching to the created user The next step is to install apache on our local machine, but before then you have to update and upgrade the apt repository on our vagrant box(Debian 11 Linux Distro). To upgrade and update, run this command. sudo apt update && sudo apt upgrade To install apache on your vagrant box and ensure its service always runs immediately after boot, run the following commands. sudo apt install apache2 # Installation of Apache sudo systemctl enable apache2 # Enabling apache server after boot At this point, if we curl at our IP address from the vagrant box we should be able to see the official webpage of apache. To see this webpage in the command line, run this set of commands. ip a # Command to show your ip address curl http:// # check for apache server running Now, we’ve got our web server up and running. Our next task is to install PHP 8.1 and its dependencies in our vagrant box. PHP and its dependencies are needed to run a laravel app. Because PHP 8.1 is not in the default repository of Debian 11 we will have to add the repository which brings PHP 8.1 and its dependencies to the vagrant box apt repository. deb.sury.org sudo apt-get install ca-certificates apt-transport-https software-properties-common -y # Packages needed to add the deb.sury repo to our apt repo Now run this command to add the deb.sury repository to our vagrant apt repository. sudo echo "deb https://packages.sury.org/php/ $(lsb_release -sc) main" | sudo tee /etc/apt/sources.list.d/sury-php.list To ensure the added repository is secured and working properly, the GPG(GNU Privacy Guard) key is downloaded and used to crosscheck with the repository certificate. To go about this, run this command: sudo wget -qO - https://packages.sury.org/php/apt.gpg | sudo apt-key add - Next, we update and upgrade our apt repository and install PHP 8.1 and it’s dependencies. sudo apt update && sudo apt upgrade -y # repo update and upgrade sudo apt install php8.1 # install php8.1 Having installed PHP 8.1, we install the PHP dependencies needed for our app. sudo apt install php8.1-mysql libapache2-mod-php php8.1-imap php8.1-ldap php8.1-xml php8.1-fpm php8.1-curl php8.1-mbstring php8.1-zip # php dependencies To manage these dependencies needed by the laravel app, laravel utilises for this management. So we install composer into our vagrant machine. composer sudo curl -sS https://getcomposer.org/installer | php Move the downloaded file to your folder in other to use the composer command globally. usr/local/bin sudo mv composer.phar /usr/local/bin/composer Our laravel code resides in this GitHub which we need to clone into our folder. To clone a project from a GitHub repo you must have git installed on your vagrant machine. repo /var/www/html sudo apt install git -y # install git cd /var/www/html # change directory sudo git clone https://github.com/f1amy/laravel-realworld-example-app.git # get app code cd laravel-realworld-example-app With the app code in our vagrant box, the laravel app is started by running this command sudo composer create-project Next, we have to set the ownership and permission on our laravel app folder. sudo chown -R www-data:www-data /var/www/html/laravel-realworld-example-app/ sudo chmod -R 775 /var/www/html/laravel-realworld-example-app/ With our apache web server already running in the background, we need to create an apache virtual host configuration file to link our laravel app directory to our web server such that we start seeing the content of our app and not the apache official page. sudo vi /etc/apache2/sites-available/laravel.conf Then add these configuration lines to the created file. laravel.conf ServerAdmin admin@example.com DocumentRoot /var/www/html/laravel-realworld-example-app/public/ Options Indexes FollowSymLinks AllowOverride All Require all granted LogLevel debug ErrorLog ${APACHE_LOG_DIR}/error.log CustomLog ${APACHE_LOG_DIR}/access.log combined For the configuration in the file to take effect we will need to run the following command so it gets recognised by the apache server as the required configuration to be used and not its default configuration found in . laravel.conf 000-default.conf sudo a2enmod rewrite sudo a2ensite laravel.conf At this point, we can simply reload our apache server and our app will be deployed. To reload our apache server run this command. sudo systemctl reload apache2 Our database is not currently synched with the laravel app. For this project, we will use the MySQL database with our app. To get started with the syncing, we’ll install the MySQL package on our laravel app. Run the commands in the home directory of the created user. sudo wget https://dev.mysql.com/get/mysql-apt-config_0.8.22-1_all.deb # download mysql repo sudo apt install ./mysql-apt-config_0.8.22-1_all.deb # install packages needed for the mysql server sudo apt update # updating our apt repository sudo apt install mysql-server # installation of the mysql server Once we have MySQL server installed you will be prompted to create a root password. This password will be needed to get into the MySQL command line in other to create a database table. To create your database table and user needed for our app; sudo mysql -u root -p # use created root password ## This commands are run the the mysql commandline ## create database laravel; # database creation create user 'laravel'@' ' identified by 'password'; # user creation grant all privileges on laravel.* TO laravel@ ; # granting privilege to created user flush privileges; quit; Now we have our database set up let’s link it up with our app. This linking will be done in the file located in our laravel app directory. .env cd /var/www/html/laravel-realworld-example-app # change directory into app directory if not already in the directory sudo mv .env.example .env sudo php artisan key:generate sudo vi .env Then add these configuration lines to the created file .env APP_URL=http://"your server IP" DB_PORT= "3306" DB_USERNAME= laravel DB_HOST="your server IP" DB_DATABASE= "name of the database you created" DB_PASSWORD= "the mysql password of the laravel user you created in the mysql command line" Once this is done then migrate data in your database to make it accessible in your app. sudo php artisan migrate --seed Finally, reload your apace once again and you are done. sudo systemctl reload apache2 That’s it for this tutorial. As usual, please let me know if you have any questions or concerns in the comments. Thank you for reading! Lead image source