Requisitos

O que um servidor precisa antes de instalar o Bondry, em hospedagem compartilhada e em VPS, e como conferir sem acesso a terminal.

O Bondry é uma aplicação PHP. Não há Node, não há etapa de build e não há serviço para manter vivo além de uma linha de cron. Esta página lista o mínimo para hospedagem compartilhada e a configuração recomendada para VPS, para que você confira a hospedagem antes de comprar.

Resumo#

Hospedagem compartilhada (mínimo)#

Confira cada linha no painel da hospedagem (cPanel, Plesk ou DirectAdmin).

Cron e fila#

Adicione uma linha, a cada minuto:

* * * * * php /caminho/para/bondry/artisan schedule:run >> /dev/null 2>&1

O agendador cuida da limpeza, do heartbeat da licença, da verificação diária de atualizações, da limpeza de arquivos, da movimentação de armazenamento, dos webhooks, das importações RSS e dos resumos. Ele não executa um worker de fila. O Bondry não exige worker: a indexação de busca roda após a resposta, no mesmo processo. Se o driver de fila for database e mais de 100 jobs esperarem, a página de saúde do painel avisa que nenhum worker está rodando. Se a hospedagem não tem cron, a Configuração Avançada oferece um modo que executa as tarefas vencidas pelo tráfego do site, no máximo uma vez por minuto.

Disco#

Planeje 500 MB livres antes dos uploads.

Hospedagens comuns#

Qualquer hospedagem cPanel, Plesk ou DirectAdmin com os valores acima funciona. O instalador verifica cada item antes de gravar qualquer coisa, então uma hospedagem que não atende é apontada antes de alterar a sua conta.

VPS ou servidor dedicado (recomendado)#

O MySQL se beneficia mais de RAM e SSD.

Pilha de software#

Um bloco de servidor Nginx mínimo:

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;
    }
}

Propriedade dos arquivos#

O código é legível pelo usuário do PHP. Apenas storage, bootstrap/cache, modules, themes e public/uploads têm escrita. Defina o dono como o usuário do PHP-FPM em vez de abrir os diretórios para todos.

Ambientes testados#

Conferindo antes de comprar#

• Envie um arquivo com <?php phpinfo(); e procure a versão do PHP, a lista de extensões e os valores de memory_limit, upload_max_filesize, post_max_size e max_input_vars. Apague o arquivo depois.
• Cron: abra a seção de cron do painel e confirme que dá para adicionar uma tarefa a cada minuto com a linha de comando do PHP.
• HTTPS de saída: pergunte à hospedagem, ou rode um arquivo PHP de uma linha com var_dump(file_get_contents('https://api.bondry.org')); e confira que não há erro de conexão. Apague depois.

Problemas comuns#