Instalação

O TubePress é instalado como qualquer aplicação PHP clássica: faça o upload dos arquivos, aponte um navegador para o seu domínio e siga um breve assistente de instalação web. Sem linha de comando, sem etapa de compilação.

Reserve cerca de cinco minutos. Antes de começar, confirme se seu servidor atende aos requisitos e tenha os dados do banco de dados em mãos.

Baixar o TubePress

Baixe a versão mais recente na página de download. É um único ZIP pequeno contendo o código-fonte PHP completo e editável — sem chave de licença e sem ionCube.

Enviar para o seu servidor

Extraia o ZIP e faça o upload do seu conteúdo para o servidor via FTP/SFTP ou pelo gerenciador de arquivos do seu provedor. A regra principal é: a raiz web deve apontar para o diretório public/, não para a raiz do projeto. Todo o restante — config/, src/, storage/, themes/, plugins/ — fica um nível acima da raiz do documento e nunca é servido diretamente.

Executar o instalador web

Acesse o seu domínio em um navegador. Como ainda não existe o marcador config/installed.php, o TubePress o direciona diretamente para o assistente de configuração. Ele possui seis etapas:

1. Boas-vindas. Uma breve tela de introdução — clique para começar.
2. Verificação do Sistema. Verifica a versão do PHP, extensões e pastas com permissão de escrita. Quando todas as verificações obrigatórias passam, o sistema avança automaticamente; se algo falhar, cada item se expande com instruções de como corrigi-lo.
3. Banco de Dados. Informe o host, nome, usuário e senha do banco de dados. O TubePress se conecta, cria o banco de dados se possível (ou usa um existente em hospedagem compartilhada), executa todas as migrações SQL e grava config/database.php. O campo host também aceita host:port ou um caminho de socket.
4. Administrador. Crie sua conta de administrador — um nome de usuário (3–50 caracteres), um e-mail válido e uma senha de pelo menos 8 caracteres.
5. Configurações. Nomeie o seu site (a descrição é opcional). A URL do site é detectada automaticamente e o número de vídeos por página tem padrão 24 — ambos editáveis posteriormente.
6. Concluído. O TubePress cria as páginas padrão, configurações e valores padrão de SEO, grava o marcador de instalação e fornece o link para o seu novo painel de administração.

Permissões de arquivos

O usuário do servidor web (geralmente www-data) deve ser proprietário e ter permissão de escrita em três locais: config/ (para salvar as configurações), storage/ (logs, arquivos temporários e backups) e public/uploads/ (seus arquivos de mídia). A Verificação do Sistema sinaliza os que não têm permissão de escrita.

# Give the web-server user ownership
chown -R www-data:www-data config storage public/uploads

# Directories 755, files 644
find config storage public/uploads -type d -exec chmod 755 {} \;
find config storage public/uploads -type f -exec chmod 644 {} \;

Apenas esses três caminhos precisam ter permissão de escrita pelo servidor; o restante da árvore pode permanecer somente leitura.

Apache vs Nginx

Ambos são totalmente suportados e detectados automaticamente durante a instalação.

• Apache — defina AllowOverride All para que os arquivos .htaccess incluídos possam gerenciar URLs amigáveis e bloquear o acesso a pastas sensíveis. Ao concluir, o TubePress cria symlinks public/themes e public/templates para que os assets do tema sejam resolvidos.
• Nginx — adicione a regra padrão try_files … /index.php?$query_string, crie alias de /themes/ e /templates/ para as pastas do projeto, e bloqueie (deny) os caminhos config/, src/ e storage/. Exemplos completos estão em Requisitos.

Desenvolvimento local (localhost)

O TubePress funciona em uma instalação localhost com HTTP simples, sem configuração especial — o instalador, as sessões e o login funcionam sem HTTPS. Duas opções simples:

• Um servidor web local (mais próximo da produção) — aponte o Apache ou Nginx para a pasta public/, exatamente como descrito acima.
• Servidor embutido do PHP (zero configuração) — a partir da raiz do projeto, execute o comando abaixo e abra http://localhost:8000.

php -S localhost:8000 -t public public/router.php

O router.php incluído fornece URLs amigáveis, e o controlador frontal serve os assets do tema e do admin diretamente — assim o estilo funciona de imediato, mesmo sem configurar aliases de assets.

Após a instalação

Faça login em /admin com a conta recém-criada e comece a configurar o seu site. O guia de primeiros passos orienta sobre identidade do site, identidade visual, seus primeiros vídeos e uma lista de verificação para entrar em produção. Vale também reforçar a segurança do login de admin desde cedo — consulte Segurança.

Próximos passos