WAF Documentations

Table of Contents

1. Database Creation

1.1 cPanel

  1. Log in to your cPanel.
  2. Go to MySQL Databases.
  3. Create a new database and note the database name.
  4. Create a new database user and assign it to the database with all privileges.

1.2 Hostinger

  1. Log in to Hostinger's hPanel.
  2. Navigate to Databases > MySQL Databases.
  3. Create a new database and user.
  4. Copy the database details for later use.

1.3 Plesk

  1. Log in to your Plesk panel.
  2. Go to Databases and click Add Database.
  3. Enter the database name and create a new database user.
  4. Grant full privileges to the user.

2. Uploading Files

  1. Download the WAF zip package.
  2. Use File Manager or an FTP client (e.g., FileZilla) to upload the package to your root directory.
  3. Extract the files inside the public_html folder.

3. Enabling Required PHP Extensions

3.1 cPanel

  1. Log in to cPanel.
  2. Go to Select PHP Version under Software.
  3. Select PHP 8.2 or later.
  4. Enable the following extensions:
    • allow_url_fopen
    • Imagick
    • Ioncube Loader

3.2 Hostinger

  1. Log in to Hostinger's hPanel.
  2. Go to Advanced > PHP Configuration.
  3. Enable the required extensions (Imagick, Ioncube, allow_url_fopen).

3.3 Plesk

  1. Log in to Plesk.
  2. Go to PHP Settings.
  3. Enable required extensions (Imagick, Ioncube, allow_url_fopen).

4. Installation Steps

  1. Open your browser and visit yourdomain.com/install/.
  2. The installer will check the server requirements (PHP 8.2+, allow_url_fopen, Imagick, Ioncube, etc.).
  3. Enter the database credentials created earlier.
  4. Provide a valid license key.
  5. Click Install and wait for the setup to complete.

5. Final Setup

  1. Verify the installation by visiting yourdomain.com.
  2. Delete the /install folder for security purposes.
  3. Your website is now ready!

6. Configuring Google OAuth

  1. Go to Google Cloud Console and create a new project.
  2. Navigate to APIs & Services > Credentials.
  3. Click Create Credentials and select OAuth Client ID.
  4. Set the application type to Web Application and enter a name.
  5. Under Authorized Redirect URIs, add: https://yourdomain.com/oauth/google/callback.
  6. Click Create and copy the Client ID and Client Secret.
  7. Update your .env file with the following:

    Note: The .env file already includes placeholders for OAuth settings at the bottom. You only need to fill in the values.

    GOOGLE_CLIENT_ID=your-client-id
GOOGLE_CLIENT_SECRET=your-client-secret
  8. Save the file.

7. Installing on Hostinger (hPanel)

The following steps explain how to perform a complete WAF installation on Hostinger using hPanel:

  1. Open hPanel and select the domain you want to use.
  2. Go to Files > File Manager.
  3. Enter the public_html folder and upload the WAF ZIP file you downloaded earlier.
  4. Once the upload is complete, right-click the ZIP file > Extract.
  5. Go to Databases > MySQL Databases and create:
    • Database Name
    • Database User
    • Password
    Record these details for the next installation step.
  6. Then go to Advanced > PHP Configuration:
    • Select PHP version 8.2 or later.
    • Make sure the following extensions are enabled:
      • Imagick
      • Ioncube Loader
      • allow_url_fopen
  7. Open your browser and visit https://yourdomain.com/install/.
  8. Fill out the installation form using the database information created earlier.
  9. Enter your License Key and proceed with the installation.
  10. After successful installation:
    • Delete the /install folder for security reasons.
    • Visit your domain to confirm the website is active.

Tip: If the page does not load after upload, make sure the .htaccess file has been extracted and the PHP mode is correct (PHP 8.2).