#Setting Up Your Bug Tracker

This guide walks you through installing the bug tracker on your own web hosting. It takes about 10 minutes and works on any standard PHP + MySQL host (these steps use Hostinger as the example, but the process is the same almost anywhere).

#What you're installing

A self-hosted tool for collecting and managing bug reports across your games, apps, or FiveM scripts:

• A public form where people report bugs
• A public status page where they can check what's fixed
• A private admin dashboard where you manage everything

#Before you start

You'll need:

• Web hosting with PHP and MySQL (shared hosting is fine)
• Access to your host's control panel (to create a database and upload files)
• The bug tracker .zip file, downloaded and unzipped on your computer

#Step 1 — Create a database

1. In your hosting control panel, find MySQL Databases (on Hostinger: hPanel → Databases → MySQL Databases).
2. Create a new database and a new database user, and set a password for that user.
3. Write down these four things — you'll need them in Step 4:
   • Database name
   • Database username
   • Database password
   • Database host (almost always localhost)

#Step 2 — Import the database structure

1. Open phpMyAdmin from the same Databases page.
2. Select the database you just created.
3. Click Import, choose the schema.sql file from the unzipped folder, and click Go.

This creates all the necessary tables and a default admin login:

You'll change this password in Step 5 — don't skip that.

#Step 3 — Upload the files

1. In your host's File Manager (or via FTP), navigate to your site's web root — usually public_html.
2. Upload the entire unzipped folder there. You can rename the folder if you want a different URL, e.g. public_html/bugs.
3. Make sure the uploads folder inside it is writable (permissions 755 or 775). Most file managers let you right-click → Permissions.

#Step 4 — Configure the site

Open config.php in your file manager's code editor and fill in:

define('DB_NAME', 'your_database_name');
define('DB_USER', 'your_database_user');
define('DB_PASS', 'your_database_password');

define('SITE_NAME', 'Your Studio Name');
define('SITE_URL', 'https://yourdomain.com/bugs'); // no trailing slash
define('NOTIFY_EMAIL', 'you@yourdomain.com');
define('MAIL_FROM', 'noreply@yourdomain.com');

A few notes:

• SITE_URL should be the exact address where you uploaded the folder.
• NOTIFY_EMAIL is where you'll get an email every time someone submits a bug report.
• MAIL_FROM should use your own domain — most hosts silently drop emails sent "from" an address that doesn't match the domain they're hosted on.

Save the file.

#Step 5 — Log in and secure your account

1. Visit yourdomain.com/bugs/admin/login.php
2. Log in with admin / changeme123
3. Click Admins in the top bar, then change my password, and set something only you know

#Step 6 — Add your games, apps, or scripts

Still in the admin panel, click Games & Apps. Add an entry for each thing you want people to be able to report bugs against, and pick a type (Game, App, FiveM Script, or Other). This is what fills the dropdown on your public report form — no database editing required.

#You're live

#Managing bug reports

Open any report from the admin dashboard to:

• Change its status: Open, In Progress, Resolved, or Won't Fix
• Set what version it was fixed in — this shows up automatically on the public status page
• Add internal notes only admins can see
• Delete it

#Adding more admins

From Admins in the top bar, you can add a login for each teammate, and remove one if someone leaves. There always has to be at least one admin account, and you can't delete the one you're currently logged in as.

#Troubleshooting

I'm not getting email notifications.
Check that MAIL_FROM in config.php uses your own domain. Most hosts require this for mail() to work reliably. If it still doesn't work, your host may need outbound mail configured through SMTP instead.

"Database connection failed" when I visit the site.
Double check DB_NAME, DB_USER, DB_PASS, and DB_HOST in config.php exactly match what you set up in Step 1.

File uploads aren't working.
Confirm the uploads folder has write permissions (755 or 775). Attachments are limited to 5MB and a small set of safe file types by default — this can be adjusted in config.php if needed.

I forgot my admin password.
Re-import just the admins table row from schema.sql via phpMyAdmin, or ask another admin on the account to reset it for you from the Admins page.