Have you already finished building your Laravel project and now started asking yourself, \u201cMy application works perfectly on my computer, so how do I actually make it live for real users?\u201d This is usually where many beginners stop because local development and live deployment feel completely different.<\/p>\n\n\n\n
Once you start moving toward deployment, you suddenly begin seeing SSH access, Composer, PHP versions, databases, Nginx configuration, permissions, and server settings. If you are thinking, \u201cDo I really need to understand all these things first?\u201d you are not the only one.<\/p>\n\n\n\n
The good part is that Laravel deployment becomes much easier once you understand what each step actually does. By the time you finish reading, you will know how to deploy your Laravel project on a VPS, avoid common mistakes, and build a stable production environment.<\/p>\n\n\n\n
Laravel deployment on a VPS means moving your Laravel project from a local development environment to a live server where users can access your application through the internet. This process prepares the project to work in a real production environment instead of only on your computer.<\/p>\n\n\n\n
During deployment, important components are configured properly, including project files, dependencies, database connections, environment settings, and web server configurations. These configurations help your Laravel application run smoothly, handle requests correctly, and provide stable performance for visitors.<\/p>\n\n\n\n
A VPS provides dedicated resources and greater control over your hosting environment. You can install compatible PHP versions, manage server settings, run queue workers, improve security, and optimize performance based on your Laravel project requirements and future growth.<\/p>\n\n\n\n
Before moving into the actual deployment process, take a quick moment and ask yourself something: Do you already have everything ready?<\/strong> <\/p>\n\n\n\n Many beginners jump directly into installation commands and later get stuck because a required tool, package, or server detail is missing. Spending a few minutes preparing things first can save a lot of time and frustration later.<\/p>\n\n\n\n Before you continue, make sure these things are ready:<\/p>\n\n\n\n One more important thing to check before moving ahead is Laravel and PHP compatibility. Using unsupported versions can create dependency conflicts, installation problems, and unexpected application errors later.<\/p>\n\n\n\n Once these things are ready, the actual Laravel deployment process becomes much smoother, and you can focus on building and launching your application instead of fixing avoidable setup problems.<\/p>\n\n\n\n Before moving ahead with the deployment process, there is one important thing you should check carefully: are your Laravel and PHP versions compatible with each other? Using unsupported versions can create package conflicts, installation issues, and unexpected application errors later.<\/p>\n\n\n\n Laravel depends on supported PHP versions because features, package requirements, performance improvements, and security updates often change between releases. Choosing the correct combination helps your Laravel project run more smoothly and reduces compatibility problems during deployment.<\/p>\n\n\n\n Now comes the actual deployment process. At this stage, you will prepare the server, install the required software, upload your Laravel application, configure the environment, and optimize everything for production use. <\/p>\n\n\n\n If you are deploying your first Laravel application, follow the steps in the same order because skipping configurations can later create errors related to permissions, dependencies, database connections, or application performance.<\/p>\n\n\n\n The first step is connecting to your VPS server securely using SSH (Secure Shell). SSH allows you to access and manage your server remotely through terminal commands.<\/p>\n\n\n\n Most VPS providers provide:<\/strong><\/p>\n\n\n\n Basic SSH command:<\/strong><\/p>\n\n\n\n Example:<\/strong><\/p>\n\n\n\n If your server uses SSH key authentication:<\/strong><\/p>\n\n\n\n For production environments, many developers avoid using the root account continuously because root has unrestricted access.<\/p>\n\n\n\n Create a separate user:<\/strong><\/p>\n\n\n\n This improves:<\/strong><\/p>\n\n\n\n You can then switch users:<\/strong><\/p>\n\n\n\n Before installing software, update your server packages first. This reduces compatibility problems and ensures newer security fixes are installed.<\/p>\n\n\n\n Run:<\/strong><\/p>\n\n\n\n You may also remove unnecessary packages:<\/strong><\/p>\n\n\n\n Updating the server helps:<\/strong><\/p>\n\n\n\n Ignoring updates can later create package conflicts during Laravel installation.<\/p>\n\n\n\n Laravel depends on several services and packages before it can run properly.<\/p>\n\n\n\n Main components include:<\/strong><\/p>\n\n\n\n Laravel requires PHP and several extensions for application functionality.<\/p>\n\n\n\n Install PHP:<\/strong><\/p>\n\n\n\n Some commonly used Laravel PHP extensions include:<\/strong><\/p>\n\n\n\n Check PHP version:<\/strong><\/p>\n\n\n\n Make sure the installed version matches your Laravel release requirements.<\/p>\n\n\n\n Composer manages Laravel packages and dependencies.<\/p>\n\n\n\n Install Composer:<\/strong><\/p>\n\n\n\n Verify installation:<\/strong><\/p>\n\n\n\n Composer handles:<\/strong><\/p>\n\n\n\n Most Laravel applications use MySQL or MariaDB.<\/p>\n\n\n\n Install MySQL:<\/strong><\/p>\n\n\n\n Secure MySQL installation:<\/strong><\/p>\n\n\n\n Create database:<\/strong><\/p>\n\n\n\n Create user:<\/strong><\/p>\n\n\n\n Grant privileges:<\/strong><\/p>\n\n\n\n Using separate database users improves security compared to using the root database account.<\/p>\n\n\n\n Git simplifies deployment and future updates.<\/p>\n\n\n\n Install Git:<\/strong><\/p>\n\n\n\n Check installation:<\/strong><\/p>\n\n\n\n Nginx is commonly used with Laravel because it works efficiently with PHP-FPM.<\/p>\n\n\n\n Install Nginx:<\/strong><\/p>\n\n\n\n Start service:<\/strong><\/p>\n\n\n\n Enable startup:<\/strong><\/p>\n\n\n\n Verify status:<\/strong><\/p>\n\n\n\n Now upload your Laravel application files to the server.<\/p>\n\n\n\n Common upload methods:<\/strong><\/p>\n\n\n\n Git deployment example:<\/strong><\/p>\n\n\n\n Move project:<\/strong><\/p>\n\n\n\n Navigate:<\/strong><\/p>\n\n\n\n Git deployment is usually preferred because future updates become easier.<\/p>\n\n\n\n Install project dependencies:<\/strong><\/p>\n\n\n\n This command:<\/strong><\/p>\n\n\n\n Laravel uses an environment file for configuration.<\/p>\n\n\n\n Create:<\/strong><\/p>\n\n\n\n Open:<\/strong><\/p>\n\n\n\n Example:<\/strong><\/p>\n\n\n\n For production:<\/strong><\/p>\n\n\n\n Leaving debug enabled in production can expose sensitive application information.<\/p>\n\n\n\n Generate Laravel application key:<\/strong><\/p>\n\n\n\n Run database migration:<\/strong><\/p>\n\n\n\n Optional database seeding:<\/strong><\/p>\n\n\n\n If your project uses uploads:<\/strong><\/p>\n\n\n\n This creates a symbolic link between storage and public directories.<\/p>\n\n\n\n Create configuration:<\/strong><\/p>\n\n\n\n Add:<\/strong><\/p>\n\n\n\n Enable configuration:<\/strong><\/p>\n\n\n\n\n
Laravel Version<\/strong><\/td> Recommended PHP Version<\/strong><\/td> Support Status<\/strong><\/td> Recommended Usage<\/strong><\/td><\/tr> Laravel 10<\/td> PHP 8.1+<\/td> Long Term Support<\/td> Stable production applications<\/td><\/tr> Laravel 11<\/td> PHP 8.2+<\/td> Current Stable Release<\/td> Modern web applications<\/td><\/tr> Laravel 12<\/td> PHP 8.2+<\/td> Latest Release<\/td> New projects and latest features<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
\n\n\n\nLaravel and PHP Version Compatibility<\/h2>\n\n\n\n
Laravel Version<\/strong><\/td> Recommended PHP Version<\/strong><\/td> Support Status<\/strong><\/td> Recommended Usage<\/strong><\/td><\/tr> Laravel 10<\/strong><\/td> PHP 8.1+<\/td> Long Term Support<\/td> Stable production applications<\/td><\/tr> Laravel 11<\/strong><\/td> PHP 8.2+<\/td> Current Stable Release<\/td> Modern web applications<\/td><\/tr> Laravel 12<\/strong><\/td> PHP 8.2+<\/td> Latest Release<\/td> New projects and latest features<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
\n\n\n\nHow to Deploy a Laravel Project on a VPS (Step by Step Guide)<\/h2>\n\n\n\n
Step 1: Connect to Your VPS Using SSH<\/h3>\n\n\n\n
\n
ssh root@your-server-ip<\/code><\/pre>\n\n\n\nssh root@192.168.1.100<\/code><\/pre>\n\n\n\nssh -i private-key.pem root@your-server-ip<\/code><\/pre>\n\n\n\nadduser laraveluser\nusermod -aG sudo laraveluser<\/code><\/pre>\n\n\n\n\n
su - laraveluser<\/code><\/pre>\n\n\n\nStep 2: Update Server Packages<\/h3>\n\n\n\n
sudo apt update\nsudo apt upgrade -y<\/code><\/pre>\n\n\n\nsudo apt autoremove -y<\/code><\/pre>\n\n\n\n\n
Step 3: Install Required Software<\/h3>\n\n\n\n
\n
Install PHP and Required Extensions<\/h4>\n\n\n\n
sudo apt install php php-fpm php-cli php-mysql php-curl php-xml php-mbstring php-bcmath php-zip php-gd php-intl unzip -y<\/code><\/pre>\n\n\n\nExtension<\/strong><\/td> Purpose<\/strong><\/td><\/tr> php-fpm<\/td> Processes PHP requests<\/td><\/tr> php-mysql<\/td> Database connection support<\/td><\/tr> php-curl<\/td> API communication<\/td><\/tr> php-xml<\/td> XML support<\/td><\/tr> php-mbstring<\/td> Multi-byte string handling<\/td><\/tr> php-bcmath<\/td> Mathematical operations<\/td><\/tr> php-zip<\/td> Zip file handling<\/td><\/tr> php-gd<\/td> Image processing<\/td><\/tr> php-intl<\/td> Localization support<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n php -v<\/code><\/pre>\n\n\n\nInstall Composer<\/h4>\n\n\n\n
curl -sS https:\/\/getcomposer.org\/installer | php\nsudo mv composer.phar \/usr\/local\/bin\/composer<\/code><\/pre>\n\n\n\ncomposer --version<\/code><\/pre>\n\n\n\n\n
Install MySQL Database<\/h4>\n\n\n\n
sudo apt install mysql-server -y<\/code><\/pre>\n\n\n\nsudo mysql_secure_installation<\/code><\/pre>\n\n\n\nCREATE DATABASE laravelapp;<\/code><\/pre>\n\n\n\nCREATE USER 'laraveluser'@'localhost' IDENTIFIED BY 'StrongPassword';<\/code><\/pre>\n\n\n\nGRANT ALL PRIVILEGES ON laravelapp.* TO 'laraveluser'@'localhost';\nFLUSH PRIVILEGES;<\/code><\/pre>\n\n\n\nInstall Git<\/h4>\n\n\n\n
sudo apt install git -y<\/code><\/pre>\n\n\n\ngit --version<\/code><\/pre>\n\n\n\nInstall Nginx<\/h4>\n\n\n\n
sudo apt install nginx -y<\/code><\/pre>\n\n\n\nsudo systemctl start nginx<\/code><\/pre>\n\n\n\nsudo systemctl enable nginx<\/code><\/pre>\n\n\n\nsudo systemctl status nginx<\/code><\/pre>\n\n\n\nStep 4: Upload Your Laravel Project to VPS<\/h3>\n\n\n\n
Method<\/strong><\/td> Best For<\/strong><\/td> Difficulty<\/strong><\/td><\/tr> Git Clone<\/td> Production deployment<\/td> Easy<\/td><\/tr> SFTP\/FileZilla<\/td> Small projects<\/td> Easy<\/td><\/tr> SCP<\/td> Direct file transfer<\/td> Medium<\/td><\/tr> GitHub Actions<\/td> Automated deployment<\/td> Advanced<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n git clone https:\/\/github.com\/username\/project.git<\/code><\/pre>\n\n\n\nsudo mv project \/var\/www\/<\/code><\/pre>\n\n\n\ncd \/var\/www\/project<\/code><\/pre>\n\n\n\nStep 5: Install Laravel Dependencies<\/h3>\n\n\n\n
composer install --optimize-autoloader --no-dev<\/code><\/pre>\n\n\n\n\n
Step 6: Configure Laravel Environment File<\/h3>\n\n\n\n
cp .env.example .env<\/code><\/pre>\n\n\n\nnano .env<\/code><\/pre>\n\n\n\nAPP_NAME=LaravelApp\nAPP_ENV=production\nAPP_DEBUG=false\nAPP_URL=https:\/\/yourdomain.com\nDB_CONNECTION=mysql\nDB_HOST=127.0.0.1\nDB_PORT=3306\nDB_DATABASE=laravelapp\nDB_USERNAME=laraveluser\nDB_PASSWORD=StrongPassword<\/code><\/pre>\n\n\n\n\n
Step 7: Generate Application Key and Run Database Migrations<\/h3>\n\n\n\n
php artisan key:generate<\/code><\/pre>\n\n\n\nphp artisan migrate<\/code><\/pre>\n\n\n\nphp artisan db:seed<\/code><\/pre>\n\n\n\nphp artisan storage:link<\/code><\/pre>\n\n\n\nStep 8: Configure Nginx for Laravel<\/h3>\n\n\n\n
sudo nano \/etc\/nginx\/sites-available\/laravel<\/code><\/pre>\n\n\n\nserver {\n listen 80;\n server_name yourdomain.com;\n root \/var\/www\/project\/public;\n index index.php;\n location \/ {\n try_files $uri $uri\/ \/index.php?$query_string;\n }\n location ~ \\.php$ {\n include snippets\/fastcgi-php.conf;\n fastcgi_pass unix:\/run\/php\/php8.2-fpm.sock;\n }\n}<\/code><\/pre>\n\n\n\n