সার্ভারে যা লাগবে
PHP 7.4 বা নতুন, MySQL বা MariaDB, আবশ্যিক ও ঐচ্ছিক এক্সটেনশন, লেখার অনুমতিসহ ফোল্ডার, FFmpeg, আপলোডের সীমা যা দ্রুত পথ মানে না, ডিস্ক ও ব্যান্ডউইথ।
BoxPuff is a plain PHP and MySQL script. It runs on ordinary shared hosting with cPanel, on a VPS with Apache, Nginx or LiteSpeed, and on Windows for development. Nothing has to be compiled and no Composer step is needed: upload, run install.php, done. This chapter lists what the server must have before you start, and what is optional.
The server
| Needs | Why |
|---|---|
| PHP 7.4 or newer (8.1 or newer is best) | The whole script. |
| MySQL 5.7+ or MariaDB 10.3+ | Every table starts with bp_; utf8mb4 is used throughout. |
| Apache with mod_rewrite, Nginx, or LiteSpeed | Clean addresses such as /Ab3/photo.jpg. Without rewriting the site still works through index.php?r=.... |
| Outgoing HTTPS (cURL) | The installer and the cron talk to the License Center at lcpanel.com; Direct file servers and S3 buckets are reached the same way. |
The installer checks the PHP version and the extensions and refuses to go on while something required is missing. After the install the same list, extended with the optional pieces, is under Admin → System Tools → Test Tools (Server requirements) and in Support Info.
PHP extensions
Required:
pdo_mysql- database accesscurl- the License Center, file servers and bucketsjson- API answersmbstring- Bengali and other scriptsopenssl- signed links and tokensfileinfo- working out file types
Optional, each unlocking a feature:
gd- thumbnails of pictures (the File Previewer plugin can use Imagick instead)zip(ZipArchive) - uploading plugin and theme packages, code backups, the Archive Manager pluginftp- FTP file serversssh2- SFTP file serversimagick- PDF thumbnails
FFmpeg (optional)
FFmpeg is needed for video thumbnails and for the Media Converter plugin. BoxPuff looks for it in /usr/bin/ffmpeg, /usr/local/bin/ffmpeg and /opt/homebrew/bin/ffmpeg, then on the PATH. On a server where it lives somewhere else, type the path in the setting ffmpeg_path (Media Converter → FFmpeg path). Shared hosts often have FFmpeg installed; ask your host if Test Tools → FFmpeg says not found.
Writable folders
The web server must be able to write into these folders (755, or 775 on hosts where PHP runs as a different user):
files/- where uploaded files live on the local server (laid out asxx/hash)uploads/anduploads/tmp/- pieces of uploads on their way in, avatars, logos, thumbnails, zips, backupscache/andlogs/plugins/andthemes/- so packages can be uploaded from the panel- the root folder itself, once, so the installer can write
config.php
PHP limits and uploads
BoxPuff's fast upload road sends each file in parallel pieces to chunk.php with PUT requests and is not bound by upload_max_filesize or post_max_size; a 2 GB file goes up fine on a host that allows 8 MB forms. The PHP limits only matter for the slow road (plain form uploads for servers that refuse PUT) and for pictures uploaded in the panel. The shipped .htaccess asks mod_php for upload_max_filesize 2048M, post_max_size 2048M, max_execution_time 3600 and memory_limit 512M; hosts that run PHP as FPM ignore those lines, which is fine. Long transfers set their own time limit to 0 while they run.
Behind Cloudflare, keep Upload piece size (MB) under 100 (Site Settings → File Uploads); the default is 32 MB.
Disk, bandwidth and more servers
A file hosting site is mostly disk and bandwidth. The local server is enough to begin with; when it fills up, add a second one: another copy of BoxPuff on its own machine (a Direct file server), an FTP or SFTP server, or any S3-compatible bucket (Amazon S3, Wasabi, Backblaze B2, DigitalOcean Spaces, Contabo, Minio, Filebase, Cloudflare R2). All of them are described in File servers. With a bucket, downloads go straight from the bucket with signed links, so the site's own bandwidth is spared.
For the fastest downloads from a local disk, enable Improved Downloads on the server: mod_xsendfile on Apache, X-Accel-Redirect on Nginx, or LiteSpeed's built-in X-LiteSpeed-Location. The web server then sends the bytes and PHP is free at once. See Downloads.
The cron
One cron line every minute runs every background job (file deletes and moves, remote URL fetches, account downgrades, pruning, notifications, the e-mail queue, server monitoring, the licence heartbeat). Hosts without a cron can use the web line instead, and until either arrives the site runs the most urgent jobs from page views. See Scheduled jobs.
Members get a welcome, verification and password e-mails, premium reminders and share notices. PHP mail() works on most hosts; SMTP with TLS is better and is set under Site Settings → Email Settings. A test button is on Admin → Configuration → E-mail & Templates.
Browsers
The file manager and the uploader are built for current Chrome, Edge, Firefox and Safari on computers and phones. Internet Explorer is not supported. The uploader uses PUT requests, drag and drop, folder upload and paste from the clipboard where the browser offers them.
A licence key
Your BoxPuff licence key (it looks like BXP-XXXX-XXXX-XXXX-XXXX) is in your account on lcpanel.com. The installer activates it before anything is written, so have it ready. Premium plugins (including Two-factor Sign-in) and the Spirit and Nova themes each need their own addon on the licence; see The licence key.