Requirements

What a server needs before you install Bondry, for shared hosting and for a VPS, and how to check it without a shell.

Bondry is a PHP application. There is no Node, no build step and no service to keep alive beyond one cron entry. This page lists the minimum for shared hosting and the recommended setup for a VPS, so you can check a host before you buy.

At a glance#

Shared hosting (minimum)#

Check each line in your hosting panel (cPanel, Plesk or DirectAdmin).

Cron and the queue#

Add one entry, every minute:

* * * * * php /path/to/bondry/artisan schedule:run >> /dev/null 2>&1

The scheduler drives pruning, the license heartbeat, the daily update check, file cleanup, storage moves, webhooks, RSS imports and digests. It does not run a queue worker. Bondry does not require a worker: search indexing runs after the response in the same process. If the queue driver is database and more than 100 jobs wait, the health page in the admin panel warns that no worker is running. If your host has no cron at all, Advanced Configuration offers a mode that runs the due tasks from site traffic, at most once a minute.

Disk#

Plan 500 MB free before uploads.

Typical shared hosts#

Any cPanel, Plesk or DirectAdmin host with the values above works. The installer verifies every item before it writes anything, so a host that falls short is reported before it changes your account.

VPS or dedicated server (recommended)#

MySQL benefits most from RAM and SSD.

Software stack#

A minimal Nginx server block:

server {
    listen 443 ssl;
    server_name example.com;
    root /var/www/bondry/public;
    index index.php;
    client_max_body_size 64m;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        include fastcgi_params;
        fastcgi_pass unix:/run/php/php8.3-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
    }
}

File ownership#

Code is readable by the PHP user. Only storage, bootstrap/cache, modules, themes and public/uploads are writable. Set the owner to the PHP-FPM user rather than making directories world writable.

Tested environments#

Checking before you buy#

• Upload a file containing <?php phpinfo(); and look for the PHP version, the extension list and the values of memory_limit, upload_max_filesize, post_max_size and max_input_vars. Delete the file afterwards.
• Cron: open the cron section of the panel and confirm you can add a job that runs every minute with the PHP command line.
• Outbound HTTPS: ask the host, or run a one-line PHP file with var_dump(file_get_contents('https://api.bondry.org')); and check it does not report a connection error. Delete it afterwards.

Common problems#