Introdução
O Joomla é um sistema de gerenciamento de conteúdo, também chamado de CMS. Ele permite criar e administrar sites, portais, páginas institucionais, blogs, áreas restritas, catálogos, intranets e outros tipos de projetos web.
Em nossa hospedagem, você pode instalar o Joomla de duas formas:
- Pelo Quick Install App: automatiza a instalação. Recomendada para a maioria dos usuários.
- Manualmente: quando você prefere controlar cada etapa do processo. Indicada para desenvolvedores, agências, migrações ou configurações personalizadas.
Antes de começar
Antes de instalar o Joomla, verifique se você já possui:
- Um domínio ou subdomínio criado no painel.
- O domínio apontando corretamente para a hospedagem.
- Certificado SSL ativo, caso deseje usar
https://.
- Acesso ao painel da hospedagem.
- Espaço disponível em disco.
- Nenhum arquivo importante na pasta onde o Joomla será instalado.
- Um e-mail válido para a conta administrativa do site.
Domínio Principal seudominio.com.br
Subdomínio portal.seudominio.com.br
Pasta Padrão public_html
Método 1 — Instalação pelo Quick Install App
O Quick Install App é o instalador rápido disponível no painel da hospedagem. Ele permite instalar o Joomla sem precisar baixar arquivos manualmente, criar banco de dados por conta própria ou configurar arquivos internos do sistema.
Passo 1 — Acesse o painel da hospedagem
Entre no painel e acesse a área de sites ou domínios.
Caminho: WEB → selecione o domínio → Quick Install App
Em seguida, escolha: Joomla.
Passo 2 — Confira o domínio selecionado
Antes de preencher os campos, confirme se você está instalando o Joomla no domínio correto (ex: seudominio.com.br). O instalador enviará os arquivos para a pasta vinculada a esse domínio.
Passo 3 — Leia o aviso de perda de dados
Aviso de Perda de Dados!
Se a sua pasta da web já tiver arquivos, o instalador poderá substituí-los ou a instalação poderá falhar. Verifique se a pasta (ex: public_html) está vazia. Não prossiga sem backup se já houver um site publicado.
Passo 4 — Preencha os campos do instalador
Preencha os dados necessários, que explicamos detalhadamente abaixo.
Explicação dos campos do instalador
- Site Name
- O nome do seu site Joomla (ex: Portal Institucional).
- Admin Username
- Nome de usuário administrador. Evite
admin ou joomla. Prefira gestor-site.
- Admin Password
- Senha forte com no mínimo 12 caracteres, incluindo maiúsculas, minúsculas, números e símbolos.
- Admin Email
- E-mail válido e monitorado (ex:
Este endereço de email está sendo protegido de spambots. Você precisa do JavaScript ativado para vê-lo.).
- Install Directory
- Para instalar no domínio principal, mantenha
/. Para uma subpasta, preencha (ex: /portal).
- PHP Version
- Versão da linguagem PHP. Use sempre uma versão recente e compatível (ex:
8.0 ou superior).
- Database Create
- Deixe ativado para que o painel crie o banco de dados e o utilizador automaticamente.
- Database Host / Name / User / Password
- O host é
localhost. Ao manter os outros campos em auto, o painel trata de os gerar de forma segura.
Método 2 — Instalação manual do Joomla
A instalação manual é indicada quando você deseja controlar todo o processo, instalar versões específicas ou migrar projetos existentes.
-
1. Baixando o Joomla
Acesse o site oficial do projeto Joomla e baixe o pacote de instalação (ex: Joomla_5.x.x-Stable-Full_Package.zip).
-
2. Enviando os arquivos pelo Gerenciador
- Acesse o Gerenciador de Arquivos e navegue até a pasta
public_html.
- Envie o arquivo
.zip do Joomla.
- Extraia os arquivos diretamente dentro de
public_html.
- Remova o arquivo
.zip enviado para libertar espaço.
-
3. Criando o banco de dados manualmente
- Vá a Bancos de Dados no painel.
- Crie um banco de dados (ex:
usuario_site_joomla) e anote-o.
- Crie um usuário para o banco (ex:
usuario_user_joomla) com uma senha forte e anote.
- O host será
localhost.
-
4. Executando o instalador do Joomla
Acesse o seu domínio no navegador. O instalador do Joomla será exibido.
- Escolha o idioma Português do Brasil.
- Informe o nome do site e crie a conta de Administrador.
- Configure o banco de dados com os dados anotados no Passo 3. Mantenha o tipo MySQLi.
- O instalador irá sugerir um prefixo para as tabelas (ex:
abc12_); recomendamos mantê-lo.
- Conclua a instalação e confirme a remoção da pasta de instalação (se solicitado).
Acessando a administração do Joomla
A área administrativa do Joomla geralmente fica em: https://seudominio.com.br/administrator. Entre usando o usuário e senha criados durante a instalação.
Checklist pós-instalação
- Ative o SSL: Confirme se o site abre com
https://.
- Configure o domínio principal: Teste as versões com e sem 'www'.
- Atualize o Joomla: Verifique sempre se há atualizações do núcleo.
- Atualize extensões: Mantenha plugins, módulos e templates na última versão.
- Remova o desnecessário: Apague extensões que não utiliza.
- URLs Amigáveis: Habilite as URLs amigáveis nas Configurações Globais.
- Fuso Horário: Ajuste para o local correto (ex: São Paulo).
- Backups: Mantenha cópias além da fornecida pela hospedagem.
- Usuários e Permissões: Crie utilizadores individuais e não partilhe o Admin.
- E-mails: Configure o SMTP para garantir a entrega.
Problemas comuns
-
O instalador rápido avisou que a pasta não está vazia
Acesse o Gerenciador de Arquivos, faça backup do que for importante, remova os ficheiros não utilizados e tente novamente.
-
O Joomla foi instalado em uma subpasta sem querer
Acontece se preencheu o campo "Install Directory" com um nome em vez de /. Terá de reinstalar no local correto ou mover os ficheiros manualmente.
-
O site abriu uma página em branco
Verifique se os ficheiros estão completos, confirme a versão do PHP, reveja os logs de erros ou teste desativar extensões recentes.
-
Erro ao conectar ao banco de dados
Revise os dados de acesso: Nome do Banco, Usuário, Senha e Host (normalmente localhost). Garanta que as permissões do utilizador estão corretas.
-
Não consigo acessar /administrator
Verifique se o domínio aponta corretamente, se instalou o Joomla na raiz ou numa subpasta, se o SSL está ativo e limpe a cache do navegador.
-
A instalação manual não inicia
Confirme se extraiu os ficheiros para a pasta correta (public_html), se o index.php está lá, e se a versão do PHP é compatível.
Glossário rápido
- CMS
- Content Management System (Sistema de Gerenciamento de Conteúdo).
- Extensão
- Recurso adicional que pode ser um Componente, Módulo, Plugin, Template ou Idioma.
- Componente
- Adiciona uma funcionalidade principal (ex: Loja virtual, Formulários).
- Módulo
- Bloco de conteúdo exibido em posições específicas do template (ex: Menu lateral, Banner).
- Plugin
- Altera ou complementa comportamentos internos (ex: Segurança, Otimização).
- Template
- Conjunto de arquivos que define o visual do site (cores, layout, tipografia).
- Administrator
- Área administrativa (ex:
seudominio.com.br/administrator).
Conclusão
A instalação pelo Quick Install App é a forma mais simples e rápida de instalar o Joomla. A instalação manual é indicada quando precisa de controlo total. Em ambos os casos, confirme o domínio correto, utilize senhas fortes, ative o SSL e mantenha as extensões atualizadas.
