Requisitos do servidor

TubePress roda em uma pilha LAMP ou LEMP comum. Não há framework para instalar, nenhuma etapa de build com Composer ou Node, e nenhum loader ionCube — se o seu servidor já executa WordPress, quase certamente conseguirá executar TubePress.

Esta página cobre o mínimo necessário, a configuração recomendada para produção e as poucas partes opcionais (FFmpeg, uma conta TubePress) que apenas recursos específicos exigem. O instalador web verifica tudo isso para você na etapa de Verificação do Sistema.

Requisitos mínimos

Este é o piso. O instalador se recusará a continuar até que todos os itens obrigatórios sejam aprovados.

Extensões PHP obrigatórias

A instalação é bloqueada se estas três não estiverem presentes:

Sessões PHP funcionando e reescrita de URL no servidor (Apache mod_rewrite ou regra Nginx try_files) também são obrigatórias — o instalador verifica ambas.

Configuração recomendada

Para um site de produção tranquilo:

• PHP 8.4 com OPcache — a versão contra a qual TubePress é construído e testado, com o cache de bytecode ativado para maior velocidade.
• memory_limit de 256 MB ou mais — folga confortável para importações em massa e processamento de imagens.
• curl, zip e GD (ou Imagick) — opcionais mas recomendadas: downloads de catálogo e o marketplace usam curl, a instalação de temas e plugins pelo painel requer zip, e a geração de miniaturas requer GD ou Imagick.
• HTTPS — sirva o site via TLS e defina a URL do seu site para o endereço https.

Tarefas agendadas são executadas automaticamente pelo pseudo-cron integrado do TubePress, portanto nenhum crontab do sistema é necessário. Sites de alto tráfego ainda podem usar um cron real — veja Cron & CLI.

Limites de upload para vídeo

TubePress limita uploads diretos a 500 MB por padrão (ajustável em /admin/settings). Os limites do seu PHP e do servidor web devem ser pelo menos tão grandes, ou arquivos grandes serão rejeitados antes de chegarem ao aplicativo:

; php.ini - allow large video uploads
upload_max_filesize = 512M
post_max_size       = 512M
memory_limit        = 256M
max_execution_time  = 300

No Nginx, também aumente o client_max_body_size; no Apache, o LimitRequestBody. Para bibliotecas muito grandes, transcodifique e sirva a partir de armazenamento remoto — veja Transcodificação e Armazenamento.

Servidor web

A raiz web é o diretório public/, e toda solicitação é roteada por um único controlador frontal, public/index.php. Mantenha config/, src/ e storage/ acima da raiz do documento (eles ficam um nível acima de public/) para que nunca possam ser servidos diretamente.

Apache

Aponte a raiz do documento para public/ e permita que os arquivos .htaccess incluídos façam seu trabalho:

DocumentRoot /var/www/tubepress/public
<Directory /var/www/tubepress/public>
    AllowOverride All
    Require all granted
</Directory>

Nginx

Use try_files para URLs limpas, crie alias para as pastas de temas e templates, e negue os caminhos sensíveis:

server {
    root /var/www/tubepress/public;
    index index.php;

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

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php8.4-fpm.sock;
    }

    # Serve theme and template assets
    location /themes/    { alias /var/www/tubepress/themes/; }
    location /templates/ { alias /var/www/tubepress/templates/; }

    # Never expose application internals
    location ~ ^/(config|src|storage)/ { deny all; }

    client_max_body_size 512M;
}

Ambos os servidores são de primeira classe — o instalador detecta automaticamente qual você está usando.

Opcional: FFmpeg & transcodificação

Você só precisa do FFmpeg se quiser que o TubePress transcodifique vídeos localmente — convertendo uploads para formatos compatíveis com a web e gerando miniaturas de prévia. Se você importar arquivos já codificados ou servir a partir de armazenamento externo ou CDN, pode ignorá-lo completamente. Veja Transcodificação.

Opcional: uma conta TubePress

O CMS é completo e gratuito por si só. Uma conta TubePress gratuita desbloqueia extras sob demanda — créditos de IA, o catálogo com mais de 400 mil vídeos, o marketplace e suporte. Você começa com 150 créditos gratuitos e nunca precisa de uma conta para rodar um site completo.

Próximos passos