To deploy your Laravel project on an Apache or Nginx server, follow these steps. We’ll use PuTTY for server connection and Git to pull the project from a remote repository. We’ll also cover database setup and file permissions configuration.

Step 1: Connect to the Server via SSH

First, use PuTTY or any other SSH client to connect to your server.

Host: Your server’s IP address or domain.

User: root or another privileged user.

Once connected, navigate to your project directory:

cd /var/www/html/your-domain

or

cd /var/www/html/your-domain/your-sub-domain

Step 2: Initialize Git and Pull Your Project

Set up Git in the project directory and pull the latest code from the remote repository:

git init

git remote add origin https://github.com/gsoroar/test.git

git pull origin main 

Step 3: Install Dependencies

If you haven’t installed Composer, you can do so with the following command:

apt install composer

Next, install project dependencies:

composer install   # Use ‘composer update’ if updating existing dependencies

Step 4: Environment Setup

Copy the example environment file and generate a new application key:

cp .env.example .env

php artisan key:generate

Step 5: Database Setup

Create a new database on your server using your preferred database management tool (e.g., MySQL or phpMyAdmin).

Update the .env file with your database credentials:

DB_DATABASE=your_database_name

DB_USERNAME=your_db_username

DB_PASSWORD=your_db_password

Run database migrations:

php artisan migrate

Step 6: Handle File and Directory Permissions

Laravel requires specific permissions on certain directories to allow writing. If you’re encountering permission issues, adjust permissions as follows (especially for Apache servers):

sudo chown -R www-data:www-data /var/www/html/your-domain/storage

sudo chown -R www-data:www-data /var/www/html/your-domain/bootstrap/cache

sudo chmod -R 775 /var/www/html/your-domain/storage

sudo chmod -R 775 /var/www/html/your-domain/bootstrap/cache

or

sudo chown -R www-data:www-data /var/www/html/your-domain/your-sub-domain/storage

sudo chown -R www-data:www-data /var/www/html/your-domain/your-sub-domain/bootstrap/cache

sudo chmod -R 775 /var/www/html/your-domain/your-sub-domain/storage

sudo chmod -R 775 /var/www/html/your-domain/your-sub-domain/bootstrap/cache