Installation

This guide will walk you through the installation process for PanGuards, a Laravel script.

Prerequisites #

• Web server (e.g., Apache, Nginx)
• PHP >= 7.4.0
• MySQL or MariaDB
• Zip file containing PanGuards files

Server Installation Steps #

Follow these steps to extract files, configure the environment, set permissions, and finalize installation by accessing the setup page.

Step 1: Extract Files #

1. Extract the contents of the provided zip file to your server’s root directory.

Step 2: Configure Environment #

1. Locate the .env file in the root directory of the PanGuards application.
2. Open the .env file using a text editor.
3. Configure the app variables according to your environment:

  - APP_ENV=production
  - APP_DEBUG=false (Set to true for development)
  - APP_URL=http://your-domain.com (Replace your-domain.com with your actual domain)

4. Configure your database settings:

     DB_CONNECTION=mysql
     DB_HOST=127.0.0.1
     DB_PORT=3306
     DB_DATABASE=your_database_name
     DB_USERNAME=your_database_username
     DB_PASSWORD=your_database_password

5. Configure your email settings:

     MAIL_MAILER=smtp
     MAIL_HOST=smtp.mailtrap.io
     MAIL_PORT=2525
     MAIL_USERNAME=null
     MAIL_PASSWORD=null
     MAIL_ENCRYPTION=null
     [email protected]
     MAIL_FROM_NAME="${APP_NAME}"

Step 3: Set Permissions #

1. Ensure that the appropriate permissions are set for directories and files within the PanGuards application. This may vary depending on your server setup.

Step 4: Optional – Update Composer #

1. If you wish to update the Composer dependencies, you can do so by running the following command in the root directory of the PanGuards application:

composer update --no-dev

Step 5: Final Steps #

1. Once the configuration is complete, visit http://your-domain.com/setup in a web browser to access PanGuards setup.
2. You will be prompted to set up the administrator account and other initial configurations upon first access.