Troubleshooting
The problems that come up most often, each with where to look and what to do.
The problems that come up most often, each with where to look and what to do.
First: read the logs
Admin → Logs → Files shows the error logs of the site. When you cannot get into the admin panel, open the same files by FTP in cache/logs/:
php.logandfatal.log— PHP errors, with the file and the line.plugins.log— a plugin that failed to start.mail.log— e-mails that could not be sent, and why.
A white page or "500 Internal Server Error"
- PHP is older than 8.1. cPanel → Select PHP Version → choose 8.1 or newer.
- A required extension is missing. Open
/install.phpon a fresh upload, or Admin → System status: both list the extensions. - A plugin broke it. Rename its folder by FTP (
plugins/name→plugins/name.off) and reload. - A half-finished update. Extract the update ZIP over the site once more, then open
/db_update.php.
The home page works, every other address answers 404
Clean addresses need URL rewriting.
- Apache / LiteSpeed: the file
.htaccessmust be in the folder of the site. File managers hide files that start with a dot; switch on Show hidden files and upload it again from the package. - nginx: add the rules from
docs/nginx.conf.txtto the server block and reload nginx. - No rewriting available: switch off Admin → Settings → Advanced → Clean addresses. The site then uses
index.php?r=...addresses, which work everywhere. You can always reach the admin panel at/index.php?r=admin.
E-mails do not arrive
- Admin → Settings → E-mail: save, then press Test the connection. It checks the host, the encryption and the sign-in step by step without sending anything, and names the step that fails (wrong port, no STARTTLS, wrong password, "app password" needed). Then Send a test e-mail.
- Use SMTP with a mailbox on your own domain. Mail sent by PHP itself often lands in spam. Leave Encryption on Auto: the site picks SSL for port 465 and STARTTLS for 587, and tries the other ones when the server refuses.
- If that fails, try the other way too (on by default): when SMTP is down the mail goes out through PHP mail(), and the other way round — so a mail that can go, goes.
- Admin → E-mail templates → Sent is the report: every e-mail the site tried, which way it went (SMTP or MAIL), how long it took and the exact error when it failed. Queue lists what is waiting. E-mails leave through the cron job: check Admin → Cron says Healthy.
- The From address must be on your own domain, and its SPF record should allow your server (ask your host).
- A bounce from Gmail saying "The IP address sending this message does not have a PTR record" means the mail left your server but Gmail refused it: the server has no reverse DNS. The settings page shows a red line when it finds this. Either ask your host to set a PTR record for the server's IP, or send through someone else's servers: choose An e-mail service over HTTPS (Brevo, SendGrid, Mailgun, Resend or Postmark; paste the API key and add your sender in the service), or fill SMTP with one click for Gmail (with an app password), Outlook, Zoho or a relay. A cPanel mailbox on the same server does not help, because the mail still leaves from the same IP.
- The logo travels inside the e-mail, so it shows even when the mail program blocks pictures from the internet.
Members cannot upload
- "The file is bigger than the server allows." PHP's
upload_max_filesizeandpost_max_sizeare lower than the limit on Admin → Settings → Posts & uploads. Raise them in cPanel → MultiPHP INI Editor. - "Too many uploads. Please wait a little." The hourly limit on the same page was reached.
- Nothing is saved.
uploads/is not writable. Set it to 755; the owner must be the user PHP runs as. - Videos stay as uploaded, without a thumbnail. FFmpeg is off or its path is wrong on the same settings page.
Calls do not connect
- The site must run on HTTPS. Browsers give no camera or microphone to a plain
http://page. - The member must allow the camera and microphone when the browser asks.
- When a call rings but stays silent on mobile data, the two phones cannot reach each other directly. Add a TURN server on the Messenger settings page.
The licence key is refused
- Key belongs to another domain. Release it on the old site (Admin → Licence → Release key) or from your account on lcpanel.com.
- The licence site cannot be reached. The server blocks outgoing HTTPS or has no certificate store. Ask the host to allow connections to
lcpanel.com. The site keeps working meanwhile. - Check that the key was copied whole, without a space at the end.
I forgot the admin password
Use Forgot password? on the sign-in page. When e-mail does not work either, open phpMyAdmin, table mmb_users, your row, and set the field password to the MD5 of a new password (choose the function MD5 in the row editor). Sign in with it: the site accepts it once and stores it safely again at that moment.
The site is closed and I cannot get in
Maintenance mode keeps the sign-in page open. Go to /login, sign in as an admin, and switch it off on Admin → Settings → General.
I moved the site to another domain or folder
- Release the licence key on the old address first.
- Edit
config.php: changeSITE_URLto the new address, without a slash at the end. - Activate the key again on Admin → Licence.
- Admin → Tools → Clear the cache.
The time is wrong
Set Admin → Settings → General → Time zone. Members can choose their own on their Settings page.
The site feels slow
- Add the real cron line, so background work is not done during page views.
- Admin → Settings → Advanced → Cache sidebars and counts for guests: 60 seconds is a good value.
- Admin → Tools → Optimise tables once in a while on a large site.
- Put a CDN in front of
uploads/and enter its address on Settings → Advanced → CDN address for uploads.
Still stuck
Open a ticket from your account on lcpanel.com. Include the address of the site, what you did, what you expected, and the last lines of cache/logs/php.log.