WAF Free Edition Documentation

# Install and configure WAF Free Edition with confidence.

Follow this guide to set up your database, upload files, enable PHP extensions, run the installer, configure Google OAuth, and complete your WAF installation.

Start Installation Hostinger Guide

## Contents

Jump to a section

Recommended Server

- PHP 8.2 or later
- MySQL database
- Imagick enabled
- Ioncube Loader enabled

Fast Setup

Install with the built-in installer.

Secure Guide

Includes final cleanup steps.

Hosting Ready

Works with cPanel, Plesk, and Hostinger.

## 1. Database Creation

Before installing WAF, create a MySQL database and database user. Keep the database name, username, password, and host information ready because you will need them during installation.

### 1.1 cPanel

1. Log in to your cPanel account.
2. Open MySQL Databases.
3. Create a new database and save the database name.
4. Create a new database user.
5. Assign the user to the database with all privileges.

### 1.2 Hostinger

1. Log in to Hostinger hPanel.
2. Go to Databases > MySQL Databases.
3. Create a new database and database user.
4. Copy the database details for the installer.

### 1.3 Plesk

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

Database Tip

Use a strong database password and never share your database credentials publicly.

## 2. Uploading Files

1. Download the WAF ZIP package.
2. Open your hosting file manager or use an FTP client such as FileZilla.
3. Upload the WAF ZIP package to your root directory.
4. Extract the files inside the `public_html` folder.
5. Make sure the `.htaccess` file exists after extraction.

## 3. Enabling Required PHP Extensions

WAF requires PHP 8.2 or later and several PHP extensions. Enable them before opening the installer.

### 3.1 cPanel

1. Log in to cPanel.
2. Open 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 hPanel.
2. Go to Advanced > PHP Configuration.
3. Select PHP 8.2 or later.
4. Enable Imagick, Ioncube Loader, and allow_url_fopen.

### 3.3 Plesk

1. Log in to Plesk.
2. Open PHP Settings.
3. Select PHP 8.2 or later.
4. Enable Imagick, Ioncube Loader, and allow_url_fopen.

## 4. Installation Steps

1. Open your browser and visit `yourdomain.com/install/`.
2. The installer will check your server requirements.
3. Enter the database credentials created earlier.
4. Provide a valid license key.
5. Click Install.
6. Wait until the setup process is complete.

Important

Do not close the installer while installation is running. Wait until the success message appears.

## 5. Default Credentials

After installation is complete, use the default administrator account below to access the admin dashboard for the first time.

    Username: admin@demo.com
    Password: 11223344

Security Reminder

Change the default admin email and password immediately after logging in. Do not keep the default credentials on a live website.

## 6. Cronjobs

Add the following cronjobs from your hosting control panel so scheduled tasks can run automatically. Replace `domain.com` with your real domain name.

### Every five minutes

    wget -q -O /dev/null https://domain.com/cron/update-price

### Daily

    wget -q -O /dev/null https://domain.com/cron/daily

Cronjob Tip

Some hosting panels ask for the interval separately. Set the update price cron to run every five minutes and the daily cron to run once per day.

## 7. Final Setup

1. Visit `yourdomain.com` to verify the website is working.
2. Delete the `/install` folder for security purposes.
3. Log in to your admin account using the default credentials above.
4. Immediately change the default admin email and password.
5. Add the required cronjobs from the Cronjobs section above.
6. Review your website settings from the admin dashboard.

## 8. Configuring Google OAuth

1. Go to Google Cloud Console.
2. Create a new project or select an existing project.
3. Go to APIs & Services > Credentials.
4. Click Create Credentials.
5. Select OAuth Client ID.
6. Set the application type to Web Application.
7. Under Authorized Redirect URIs, add:

    https://yourdomain.com/oauth/google/callback

8. Click Create.
9. Copy the `Client ID` and `Client Secret`.
10. Update your `.env` file.

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

Save the file after updating the values.

## 9. Installing on Hostinger hPanel

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

1. Open Hostinger hPanel and select the domain you want to use.
2. Go to Files > File Manager.
3. Enter the `public_html` folder.
4. Upload the WAF ZIP file you downloaded earlier.
5. After the upload is complete, right-click the ZIP file and click Extract.
6. Go to Databases > MySQL Databases.
7. Create a database name, database user, and password.
8. Save the database details for installation.
9. Go to Advanced > PHP Configuration.
10. Select PHP version 8.2 or later.
11. Enable the required extensions:
    - Imagick
    - Ioncube Loader
    - allow_url_fopen
12. Open your browser and visit `https://yourdomain.com/install/`.
13. Fill out the installation form using your database details.
14. Enter your license key.
15. Proceed with the installation.
16. After successful installation, delete the `/install` folder.
17. Log in with the default admin credentials, then change the admin email and password.
18. Add the required cronjobs from your hosting cronjob manager.
19. Visit your domain to confirm the website is active.

Installation Complete

Your WAF website is now ready. You can continue by configuring offerwalls, ads, payment methods, and website settings from the admin dashboard.

Back to Top