Install and configure WAF Free Edition with confidence.

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.

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.

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

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

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.