সমস্যার সমাধান
জানা সমস্যা ও সমাধান: ইনস্টলার লুপ, ৪০৪, লাইসেন্স পেজ, ক্রন, আপলোড, ডাউনলোড, প্রিভিউ, ই-মেইল, সাইন-ইন, বিজ্ঞাপন, ভরা ডিস্ক, ধীর পেজ, নতুন ডোমেইন।
Most problems on a new site are one of a dozen known ones. Start with Admin → System Tools → Test Tools (server requirements, folders writable, the License Center line, an outgoing connection, a file server, a test e-mail, FFmpeg, sessions) and System Logs (the newest lines of logs/*.log and PHP's error log). When you write to support, paste the block from Support Info - versions, setup, plugins, servers - it carries no passwords.
Every page shows the installer
installed.lock is missing from the root. Put it back (any content) or, on a fresh folder, run the installer. Never delete installed.lock on a live site.
Clean addresses give 404
mod_rewrite is off or .htaccess did not come along (show hidden files in the File Manager and upload it). On Nginx add the try_files rule from Installation. Until fixed, links of the form index.php?r=... still work.
The licence page is all I see
The licence is not valid or in grace: read the Status and its message on Admin → Configuration → License and press Check again now. Domain mismatch means the key is registered to another domain - change it at the License Center. An SSL certificate error from cURL is an old CA bundle: ask the host to update it, or set BP_LICENSE_INSECURE_SSL for the meantime. See The licence key.
"The cron line is not arriving"
Add the line from Background Tasks to cPanel → Cron Jobs, every minute. If it is there and the notice stays, run the command over SSH: a wrong PHP path is the usual cause; php -v shows the right one. Hosts without cron use the wget web line. Meanwhile the page heartbeat keeps the urgent jobs running. See Scheduled jobs.
Uploads fail or stop at a few MB
- The file arrived incomplete - a proxy or firewall dropped
PUTbodies. Lower Upload piece size (MB) (Site Settings → File Uploads) to 8-16, or the uploader will fall back to the form road by itself wherePUTis refused. - Behind Cloudflare, pieces must stay under 100 MB (default 32 is fine) and Behind a proxy / Cloudflare should be on so every visitor is not one address.
- Your storage is full / larger than your limit - the package (Account packages).
- No file server is available - every server is disabled, full or targeted at other packages or countries (File servers). A bucket with wrong keys stays Active and keeps being picked: set it to Disabled until the keys are right.
uploads/tmp/not writable - Test Tools → Folders writable.
Downloads
- That download link is not valid or has expired - tokens live Download link lifetime (minutes); the visitor goes back to the file page.
- That download link belongs to another address - Lock download links to the IP and a visitor whose address changes (mobile networks, some proxies, the Google document viewer). Set it to Disabled or switch on Behind a proxy / Cloudflare.
- A video does not seek - the file is streamed through PHP without
Range? Check nothing (a proxy, output compression) sits between; BoxPuff answers206itself. - Improved Downloads sends an empty or 0-byte file - the web server module is not loaded or the path is wrong (
XSendFilePath, the Nginxinternallocation). Set the server's Improved Downloads back to Disabled and read the guidance tab. - Download managers are not allowed - Block download managers for free users is on; that is by design for free accounts.
Previews and thumbnails
No thumbnails: GD (or Imagick) is missing, or the File Previewer plugin is off; the cron job Thumbnails makes missing ones every five minutes. Videos have no poster: FFmpeg is not found (Test Tools → FFmpeg; set FFmpeg path in Media Converter). Office documents do not preview: they only preview when the file is public and not password-protected, through the Google or Microsoft viewer; PDFs always open in the browser's own viewer.
E-mail does not arrive
E-mail & Templates → Send test. PHP mail() on shared hosts often lands in spam; use SMTP with the host's mail server, port 587 and TLS, and a From address on your own domain. The queue is sent by the cron job E-mail queue, so the cron must be running. Shared hosts also limit mails per hour; Newsletters respects E-mails per cron run.
Members cannot sign in
- Too many failed logins - a 24-hour block after Failed logins before a 24 h block attempts; remove it under Banned IPs.
- A member lost the authenticator - they use a backup code; or you switch two-step sign-in off for the account from Edit User.
- Sign-in works on the main site but not on a Direct file server - set User session type to Database Sessions.
- You lost the admin password - Forgot password on
/logine-mails a reset; without e-mail, set a new bcrypt hash inbp_users.passwordthrough phpMyAdmin.
Advertisements
Nothing shows: Advertising enabled is off, the package has no Show Site Adverts, or you are an admin with Hide adverts for administrators. The ad blocker limiter never triggers: the browser cached ads.js - change Adblock Filename. The demo set is still there: Remove the demo set on the Campaigns tab.
A full disk
Files land on the local server until it is full. Add a bucket or a Direct server, set the local server to Read Only, and move files from the admin's file pages. Lower Days To Keep Inactive Files on the free package, shorten Purge deleted files after, and let Auto prune work. Old backups in uploads/backups/ count too.
Slow pages
Switch on Improved Downloads; move downloads to a bucket with Direct Downloads; make sure the cron runs (without it the heartbeat runs jobs during page views); Purge caches after a change of files; Database Browser → Optimise all tables now and then.
A new domain
Change Site Settings → Site Options → Site URL, move the licence at the License Center and press Check again now, rebuild the Browser Extension packages if the plugin is on, and purge the caches. Short links stay the same.
Reading the error log
BoxPuff keeps display_errors off and writes nothing to the log on a normal page view, so anything in System Logs → php error log is worth reading. Set BP_DEBUG to true in config.php only for a minute, to see an error on screen, and set it back.