Joomla é um CMS em PHP para criar sites e portais. Instale somente uma versão atualmente suportada e extensões compatíveis; tutoriais de Joomla 1.5, 2.5, 3.x ou pacotes traduzidos por terceiros não devem ser usados em uma instalação nova. Confira os requisitos oficiais no dia da implantação.
Antes de instalar
- domínio apontado e HTTPS disponível;
- PHP, banco e extensões dentro dos requisitos da versão;
- diretório vazio ou backup dos arquivos existentes;
- banco e usuário exclusivos;
- e-mail administrativo funcional;
- senha forte e nome de usuário não previsível;
- plano de backup e atualização.
Escolher o local
Para abrir em https://dominio/, instale no document root do domínio. Para https://dominio/portal/, use a subpasta portal. Não mantenha outra aplicação no mesmo diretório e não instale uma cópia de teste dentro do site de produção sem bloqueio de acesso e indexação.
Opção 1: instalador automático
Se o cPanel oferece Softaculous ou outro instalador autorizado, abra a categoria de CMS, selecione Joomla e revise:
- protocolo HTTPS e domínio;
- diretório de instalação, deixando vazio para a raiz;
- versão suportada;
- nome e idioma do site;
- usuário, senha e e-mail administrativos;
- nome do banco e política de atualização/backup.
Não aceite credenciais fracas sugeridas por um tutorial. Depois, abra o site e o painel administrativo, confira HTTPS e remova qualquer instalação de exemplo desnecessária.
Opção 2: instalação manual
- Baixe o pacote somente do site oficial do Joomla.
- Crie banco e usuário no cPanel, concedendo privilégios ao banco correto.
- Envie o ZIP ao diretório escolhido e extraia os arquivos.
- Acesse o domínio por HTTPS para iniciar o instalador web.
- Informe site e conta administrativa.
- Configure banco com host indicado pela hospedagem, geralmente
localhost. - Revise a configuração final e conclua.
- Confirme que o diretório/estado de instalação foi removido ou desativado conforme o instalador.
Permissões
Use o proprietário correto da conta e permissões mínimas, normalmente diretórios 755 e arquivos 644 em ambientes cPanel usuais. Não aplique 777 para “resolver” gravação. Diretórios de cache e logs podem precisar de escrita pelo usuário da conta, não pelo público.
Configuração após a instalação
- ative URLs amigáveis somente após confirmar o rewrite;
- defina fuso, e-mail, cache e sessão;
- remova contas e extensões de teste;
- habilite MFA para administradores quando suportado;
- configure backup externo e teste restauração;
- instale apenas extensões mantidas e compatíveis;
- cadastre monitoramento e renovação de SSL.
Atualizações
Faça backup antes de atualizar o core ou extensões. Leia requisitos e compatibilidade, teste em homologação e não pule migrações importantes sem seguir a documentação. Uma instalação antiga sem suporte deve ser migrada, não apenas copiada para PHP novo.
Problemas comuns
| Sintoma | Verifique |
|---|---|
| Erro ao conectar ao banco | nome completo, usuário vinculado, senha e host |
| Erro 500 | log, versão PHP, extensão, .htaccess e permissões |
| URL amigável dá 404 | rewrite, arquivo de configuração e base URL |
| Página sem estilo | HTTPS, URL, cache e caminhos |
| Instalação reinicia | permissão de configuração, sessão e arquivos incompletos |
Referências: download oficial do Joomla e requisitos técnicos atuais. Para falhas depois da instalação, veja diagnóstico do Joomla.
Recursos relacionados
Continue com materiais e serviços relacionados ao tema deste guia.