Troubleshooting

Most problems have a short list of causes. Start with the section that matches what you see.

A white page or "500 Internal Server Error"

1. Open cPanel → Metrics → Errors, or the error_log file in the script's folder (and in admin/). The last lines name the file and line that failed.
2. After an update? Sign in as Super Admin and run https://your-domain/db_update.php. A missing column after uploading new files is the most common cause, and the updater adds it.
3. After editing a file? See headers already sent below.
4. PHP version — the script needs PHP 8.0 or newer. cPanel → Select PHP Version (or MultiPHP Manager) shows and changes it.
5. Memory — a very large export or backup can run out of memory; raise memory_limit to 256M.

"Cannot modify header information – headers already sent"

A PHP file was edited and saved with a byte order mark (BOM) or a blank line before <?php. Open the file named in the message in cPanel's editor and save it as UTF-8 without BOM, with <?php as the very first characters. Windows Notepad adds a BOM by default — use the cPanel editor or Notepad++ instead.

The panel is locked: "License"

The admin panel shows the licence page instead of your screens when the licence is not valid. The public website keeps working meanwhile.

• Not registered — activate your key on the License page.
• Active (offline grace period) for days on end, or Expired right after the grace period — your server cannot reach the License Center. Press Test the server connection. If it fails, ask your host to allow outgoing HTTPS to license.faruk.bd.
• Domain mismatch — the key is active on another domain (or on www. vs. a sub-domain you moved to). Release it there, or from My licences on the License Center.
• Expired — renew on the License Center, then Check now.

See The licence key.

E-mails do not arrive

1. System → E-mail Setup → Send a test message to your own address.
2. If it fails, the Mail queue shows the error. Switch the Driver to SMTP with the details of your cPanel mailbox (port 465 + SSL, or 587 + TLS).
3. If it arrives in spam, the From address must be on your own domain, and your domain needs SPF and DKIM records (cPanel → Email Deliverability sets both with one click).
4. Make sure the cron job runs — the queue is retried by it. See Scheduled jobs.

SMS or WhatsApp messages do not go out

• Settings → SMS gateway → Send a test. The answer of the gateway is shown; "insufficient balance", "invalid sender" and "IP not whitelisted" are the usual ones. Some Bangladeshi gateways must whitelist your server's IP address first.
• Settings → WhatsApp in Click-to-chat link mode never sends by itself — a person presses send in WhatsApp. For automatic sending choose GREEN-API or another gateway.
• Check the Country calling code (88 for Bangladesh): local numbers such as 01711-482019 are sent with it in front.

Clean addresses give "404 Not Found"

Pages such as /services, /book or /blog/... need Apache mod_rewrite (or LiteSpeed) and the .htaccess file in the script's folder. Check the file is there (it is hidden — enable Show hidden files in the File Manager). If your host has no rewrite support, open Website → Website Settings, untick Clean web addresses and save; the site goes back to .php addresses. Test clean addresses on the same screen tells you whether they work.

Uploads fail

• The file is bigger than Settings → General → Maximum upload size (MB), or bigger than PHP's upload_max_filesize / post_max_size (raise them in Select PHP Version → Options).
• uploads/ is not writable. Its permission should be 755 (folders) and 644 (files).
• Only pictures, PDFs and the document types a screen asks for are accepted; anything else is refused on purpose.

An addon breaks a page, or the whole panel

An addon that throws an error while loading is skipped and the rest of the panel keeps working. If one ever stops the panel from opening at all:

1. In the File Manager, rename its folder: plugins/visitors → plugins/visitors.off. The panel forgets it at once.
2. Sign in, run db_update.php, then rename the folder back and switch the addon on again under System → Addons.
3. If it fails again, keep it off and open a support ticket with the last lines of error_log.

Repair addon tables on the Addons screen creates any table a switched-on addon is missing — use it after restoring an older database.

Forgotten password

• A staff member — any Administrator can open Network → Users, edit the person and type a new Password.
• The only Super Admin — in cPanel → phpMyAdmin, open the script's database, table hcs_users, find your row and replace the value in password_hash with:

$2y$10$RwyG4R7IfLi1oGz5I8rIlepD8iGmw1Y.W5hoHjy8sOCUjH0.nq2e6

Then sign in with the password ChangeMe-2026 and change it immediately under My profile.

• Signed out by a sign-in rule — a user outside their Login window or Allowed networks is refused; an Administrator can clear the rule under Network → Authorized Users.

The dashboard numbers look wrong

• Stock and money figures follow the documents: a sale that was never completed, a purchase that was never received or a payment recorded twice shows up in the totals. System → Activity Logs shows who did what.
• With the Multi-Branch addon and Staff may only see their own branch, staff see their branch's figures only — that is intended.

The website shows old content

Your browser or a caching service (Cloudflare, LiteSpeed Cache) may be showing an old copy. Reload with Ctrl + F5, or purge the cache in that service.

Getting help

System → License → Contact the script author sends a ticket straight to support with your licence details attached. Write what you did, what you expected, and what happened instead; a screenshot and the last lines of error_log save a lot of back and forth. You can also open and follow tickets from your account on the License Center.