Como Instalar o Moodle 5.1.3+ em Servidor Linux com cPanel
Um guia passo a passo para iniciantes: do banco de dados à configuração final, com prints, comandos prontos e solução dos erros mais comuns.
O Moodle (Modular Object-Oriented Dynamic Learning Environment) é uma plataforma de aprendizado virtual (AVA) de código aberto, utilizada por milhões de instituições em todo o mundo para criar cursos online, gerenciar conteúdos educacionais e acompanhar o progresso dos alunos.
Este tutorial irá guiá-lo passo a passo pela instalação do Moodle 5.1.3+ em um servidor Linux com cPanel. Mesmo sem experiência prévia com servidores, você conseguirá concluir a instalação seguindo as instruções abaixo.
Escrito para iniciantes com acesso a um servidor Linux com cPanel. Você precisará ter acesso ao painel cPanel e, idealmente, acesso SSH ao servidor.
Antes de começar, verifique se o seu servidor atende aos requisitos mínimos listados abaixo:
| Requisito | Especificação |
|---|---|
| Sistema Operacional | Linux (CentOS 7+, Ubuntu 20.04+, AlmaLinux 8+) |
| Painel de Controle | cPanel/WHM (qualquer versão recente) |
| PHP | 8.1 ou superior — recomendado 8.2 ou 8.3 |
| Banco de Dados | MySQL 8.0+ ou MariaDB 10.6+ |
| Memória RAM | Mínimo 512 MB · Recomendado 1 GB ou mais |
| Espaço em Disco | Mínimo 200 MB + espaço para arquivos dos cursos |
| Acesso | SSH ao servidor (ou Terminal do cPanel) |
O Moodle 5.1.3+ exige PHP 8.1 ou superior. PHP 7.x não é mais suportado. Verifique a versão no cPanel em: Início > Software > MultiPHP Manager.
O Moodle precisa de um banco de dados para armazenar todas as informações dos cursos, alunos e configurações. Vamos criá-lo usando o assistente do cPanel.
Criando o banco MySQL via cPanel
Abra o navegador e acesse o painel — o endereço normalmente é:
https://seudominio.com.br:2083Faça login com seu usuário e senha de hospedagem.
Na tela inicial do cPanel, procure pela seção Banco de Dados e clique em Assistente de banco de dados MySQL (ou MySQL Database Wizard).
No campo Nome do banco de dados, digite um nome. Exemplo:
moodle_dbClique em Próximo Passo.
Preencha com um nome de usuário e uma senha forte:
Usuário: moodle_user Senha: MinhaS3nh@F0rte!Você vai precisar do nome do banco, do usuário e da senha mais adiante. Anote em um lugar seguro agora.
Na tela de privilégios, marque a opção TODOS OS PRIVILÉGIOS (ALL PRIVILEGES) e clique em Próximo Passo.
O cPanel permite gerenciar a versão do PHP de cada domínio separadamente. Vamos garantir que a versão correta esteja ativa.
Verificando a versão do PHP
No cPanel, vá em Software > MultiPHP Manager.
Localize o seu domínio na lista, marque-o e selecione a versão no menu suspenso:
PHP 8.2Clique em Aplicar.
Extensões PHP necessárias
Acesse Software > MultiPHP INI Editor e verifique se todas estão habilitadas:
- curl — comunicação com servidores externos
- gd — manipulação de imagens
- intl — suporte a internacionalização
- mbstring — suporte a caracteres multibyte (acentos)
- openssl — conexões seguras (HTTPS)
- soap — integração com sistemas externos
- xml — processamento de XML
- zip — compactação de arquivos
No MultiPHP INI Editor, selecione o domínio, procure a extensão e marque a caixa. Salve. Se não aparecer na lista, contate o suporte da hospedagem.
Vamos baixar os arquivos do Moodle diretamente para o servidor. Há duas formas: via SSH (recomendado) ou via Gerenciador de Arquivos do cPanel.
Método recomendado: Via SSH
SSH é uma forma de acessar o servidor remotamente por linha de comando — a forma mais rápida e confiável. No Windows use PuTTY ou o Terminal nativo; no Mac/Linux use o Terminal.
ssh usuario@seudominio.com.brSubstitua usuario pelo usuário cPanel e o domínio pelo endereço do servidor.
cd ~/public_htmlwget https://download.moodle.org/download.php/stable513/moodle-latest-513.tgzAguarde o download. Pode levar alguns minutos.
tar -xvzf moodle-latest-513.tgzIsso cria uma pasta moodle/ dentro de public_html.
Para o Moodle ficar em seusite.com.br (raiz), execute:
mv moodle/* . mv moodle/.* . 2>/dev/null rmdir moodleSe preferir que fique em seusite.com.br/moodle, deixe a pasta como está.
Método alternativo: Via Gerenciador de Arquivos
Sem acesso SSH? Use o método visual do cPanel (mais lento para arquivos grandes):
- Acesse cPanel > Arquivos > Gerenciador de Arquivos
- Navegue até a pasta
public_html - Clique em Upload e envie o arquivo
.tgzdo Moodle - Selecione o arquivo, clique com o botão direito e escolha Extrair
- Reorganize as pastas conforme o passo anterior
O Moodle precisa de uma pasta para armazenar arquivos enviados pelos usuários (documentos, vídeos, materiais). Esta pasta deve ficar FORA do public_html por segurança.
mkdir ~/moodledataIsso cria a pasta em /home/usuario/moodledata, fora do public_html.
chmod 777 ~/moodledataUsada durante a instalação. Após concluir, você pode restringir para 755 ou 750.
Com os arquivos no lugar, banco de dados criado e pasta moodledata pronta, execute o instalador pelo navegador.
Iniciando o instalador web
https://seudominio.com.br/O instalador iniciará automaticamente.
Selecione Português - Brasil (pt_br) e clique em Próximo.
Verifique os três caminhos mostrados:
- Diretório web: caminho para a pasta do Moodle
- Moodledata: caminho para
~/moodledata
Clique em Próximo.
Tipo: MySQL ou MariaDB Servidor: localhost Banco: moodle_db Usuário: moodle_user Senha: (sua senha) Prefixo: mdl_Aceite os termos da licença GPL. O Moodle verificará os requisitos do servidor — tudo deve aparecer em verde.
Anote o nome da extensão e volte à Etapa 2 para ativá-la, ou contate o suporte da hospedagem.
Clique em Continuar para criar as tabelas. Aguarde sem fechar o navegador — pode levar de 1 a 3 minutos.
Após concluir, preencha os dados do administrador: usuário, senha forte, e-mail, nome e sobrenome. Depois configure o nome do site e clique em Salvar alterações.
Você será redirecionado para a página inicial já logado como administrador.
Configurando o CRON
O Moodle precisa executar tarefas automáticas periodicamente (e-mails, relatórios, etc.). Configure o CRON assim:
Vá em Avançado > Trabalhos do Cron (Cron Jobs).
Selecione frequência "A cada minuto" e no campo de comando coloque:
php /home/USUARIO/public_html/admin/cli/cron.phpSubstitua USUARIO pelo seu usuário cPanel. Clique em Adicionar Trabalho do Cron.
Frequências maiores causam atrasos no envio de e-mails e notificações.
Permissões de segurança
find ~/public_html -type f -exec chmod 644 {} \; find ~/public_html -type d -exec chmod 755 {} \;chmod 400 ~/public_html/config.phpClique em cada problema para ver a solução:
Permissões incorretas nos arquivos ou erros no .htaccess. Verifique os logs em cPanel > Logs > Erros.
Reconfigure as permissões conforme a Etapa 6. Se persistir, verifique o arquivo .htaccess na raiz do Moodle.
Verifique se as credenciais no config.php estão corretas:
// Verifique estas linhas: $CFG->dbhost = 'localhost'; $CFG->dbname = 'moodle_db'; $CFG->dbuser = 'moodle_user'; $CFG->dbpass = 'sua_senha';A pasta moodledata está dentro do public_html. Ela deve ficar FORA — mova para ~/moodledata.
Verifique os seguintes pontos:
- O CRON está configurado e sendo executado regularmente?
- O cache do Moodle está habilitado em Administração > Plugins > Caching?
- O servidor tem memória RAM suficiente? (mínimo 1 GB recomendado)
- Existe algum plugin ou tema com mal desempenho instalado?
Com o Moodle instalado, aqui estão as próximas ações recomendadas:
Comentários (0)
Nenhum comentário ainda. Seja o primeiro!
Deixe seu comentário