Before Installation

Copy & Extract Package

unzip code.zip -d /var/www/{name_folder}/

Installation Instructions

Thank you for your interest in Goeasyapp

server {
    listen 80;
    server_name your-domain.com;
    root /var/www/laravel/public;

    index index.php index.html index.htm;

    client_max_body_size 200M;
    client_body_timeout 300s;
    client_header_timeout 300s;
    keepalive_timeout 300s;
    send_timeout 300s;
    fastcgi_read_timeout 300s;
    fastcgi_send_timeout 300s;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/var/run/php/php8.2-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
        fastcgi_read_timeout 300s;
        fastcgi_send_timeout 300s;
    }

    location ~ /\.ht {
        deny all;
    }
}
                

Install Dependencies

Run this command in your terminal from the project root folder:

composer install

Import Database

Before configuring the .env file, please create a new database manually (via phpMyAdmin or MySQL CLI) and then import the SQL file located at:

initial-setup/database.sql

This will set up the default tables and admin account.

Configure Database

Edit the .env file in the project root with your database information:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=your_database
DB_USERNAME=your_username
DB_PASSWORD=your_password
        

Set Permissions (Linux/Mac)

Run the following commands:

chmod -R 777 storage/logs
chmod -R 777 storage/framework/cache
chmod -R 777 storage/framework/sessions
chmod -R 777 storage/framework/views
sudo chown -R www-data:www-data public/
sudo chown -R www-data:www-data resources/
        

Finalize Laravel Setup

Run these commands to complete setup:

php artisan key:generate

Access on Localhost

Once the server is running, open http://localhost:8000 in your browser.