Como instalar o Moodle local no seu PC: Windows, XAMPP e primeiros passos

Instalar o Moodle no próprio computador é a forma mais segura de perder o medo da ferramenta: você cria cursos, usuários e provas sem afetar ninguém. Em 2026, porém, as ferramentas clássicas de instalação local ficaram para trás das versões novas.

Por que instalar o Moodle local

Uma instalação local serve para testar, treinar a equipe e errar sem consequência. Não serve para receber alunos: o próprio XAMPP avisa que não foi feito para produção, e um computador que desliga não entrega acesso, e-mail nem backup. Para um projeto real, use um servidor Linux (veja instalar o Moodle na hospedagem compartilhada). Quanto ao custo, o Moodle é gratuito; o que custa é operar.

Versões que importam e o problema do XAMPP

Cada versão do Moodle exige um mínimo de PHP e de banco, e é aí que as instalações locais quebram, segundo as páginas oficiais de requisitos:

O 5.2 também pede PHP 8.3, e todos os 5.x pedem PHP de 64 bits, extensão sodium e max_input_vars de pelo menos 5000. O último XAMPP do site oficial é de novembro de 2023, abaixo do banco de qualquer Moodle 5.x e do PHP do 5.2 e do 5.3 (tabela completa em qual versão do PHP usar no Moodle). Para ver o que o seu traz:

C:\xampp\php\php.exe -v
C:\xampp\mysql\bin\mysql.exe --version

Opção 1: o pacote do Moodle para Windows

O Moodle publica em download.moodle.org/windows pacotes prontos, montados com XAMPP para testar o Moodle num computador pessoal. As versões de 4.3 a 5.3 usam o XAMPP v8.2.4-0, e a página avisa que o XAMPP não é mais mantido e que PHP e banco recentes não atendem aos mínimos do Moodle.

1. Baixe a versão certa.Pelos requisitos acima, o 5.2 e o 5.3 (PHP 8.3) não devem rodar nesse pacote. Para estudar, use o 5.1 (segurança até 19 de abril de 2027) ou o 4.5 LTS, só no seu computador.
2. Extraia perto da raiz.Descompacte o zip numa pasta curta, como D:\moodle (caminhos longos podem travar o XAMPP), e não renomeie a subpasta server.
3. Inicie o servidor.Abra Start Moodle.exe e deixe aberto: ele liga o Apache e o banco. Para desligar, use Stop Moodle.exe.
4. Rode o instalador.Acesse http://localhost, escolha Português - Brasil, confira os caminhos, defina usuário e senha do banco e crie o administrador.
5. Se a checagem reclamar do banco.Na página de download, o Moodle diz que, só para teste, dá para ajustar o environment.xml (pasta admin; do 5.1 em diante, dentro de public), onde ficam linhas como <VENDOR name="mariadb" version="10.11.0" />. Pode causar problemas: nunca em servidor real.

Opção 2: Moodle 5.3 passo a passo

Para a versão atual, o ambiente precisa de PHP 8.3 ou 8.4 e MariaDB 11.4, MySQL 8.4 ou PostgreSQL 17. A documentação cita MAMP e Laragon como ambientes locais; o Laragon 8.7 traz PHP 8.3, 8.4 e MySQL 8.4, mas exige licença paga para uso comercial. Seja qual for o ambiente, os passos do Moodle são estes:

1. Baixe e extraia.Pegue o Moodle 5.3 em download.moodle.org e extraia fora da pasta web, como C:\moodle.
2. Crie a pasta de dados.Crie C:\moodledata, também fora da área web: a documentação vê o acesso a ela pelo navegador como risco significativo de segurança.
3. Aponte o Apache para a public.Desde o 5.1, o servidor serve a pasta public, com a regra do roteador r.php, no httpd.conf ou no host virtual:

   DocumentRoot "C:/moodle/public"
   <Directory "C:/moodle/public">
       AllowOverride None
       Require all granted
       DirectoryIndex index.php
       FallbackResource /r.php
   </Directory>

4. Ajuste o php.ini.Defina max_input_vars = 5000 e tire o ponto e vírgula das extensões curl, fileinfo, gd, intl, mbstring, openssl, sodium, zip e mysqli. Reinicie o Apache; o instalador lista o que faltar.
5. Crie o banco.Com um usuário próprio, não o root:

   CREATE DATABASE moodle DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
   CREATE USER moodleuser@localhost IDENTIFIED BY 'troque-esta-senha';
   GRANT SELECT,INSERT,UPDATE,DELETE,CREATE,CREATE TEMPORARY TABLES,DROP,INDEX,ALTER ON moodle.* TO moodleuser@localhost;

6. Instale.Pelo navegador (http://localhost) ou pela linha de comando (Prompt de Comando; o ^ continua a linha), com o PHP do mesmo ambiente. Use --dbtype=mysqli se o banco for MySQL:

   C:\php\php.exe C:\moodle\admin\cli\install.php --non-interactive --lang=pt_br ^
     --wwwroot=http://localhost --dataroot=C:\moodledata ^
     --dbtype=mariadb --dbname=moodle --dbuser=moodleuser --dbpass=troque-esta-senha ^
     --fullname="Moodle de estudo" --shortname=estudo ^
     --adminuser=admin --adminpass=defina-uma-senha-forte --adminemail=voce@exemplo.com ^
     --agree-license

7. Agende o cron.O Moodle recomenda rodar o cron a cada minuto, e a documentação manda criar a tarefa no Agendador de Tarefas do Windows:

   schtasks /create /sc minute /mo 1 /tn "Moodle cron" /tr "C:\php\php.exe C:\moodle\admin\cli\cron.php"

Mac e Linux em resumo

No Mac, o Moodle oferece o Moodle4Mac, pacote .dmg feito com MAMP, com o mesmo aviso do environment.xml: o MySQL dele (8.0) está abaixo do mínimo. No Linux, siga o guia oficial para Ubuntu, que avisa que o MariaDB padrão do Ubuntu 24.04 (10.11) não passa na checagem do Moodle 5.3, que pede 11.4. Os passos 1 a 6 valem no Linux; o cron fica no crontab.

Problemas comuns no localhost

• "localhost refused to connect" (recusou a conexão). O servidor está desligado ou em outra porta. Confira se o Start Moodle (ou o Apache) está rodando. Se o Apache não sobe, algo já usa a porta 80: o FAQ do XAMPP cita o IIS e o Skype. Se trocar a porta, abra o endereço com ela (localhost:8080) e use o mesmo valor no wwwroot.
• 404 ou "Not Found". Do 5.1 em diante, o servidor precisa servir a pasta public e ter o FallbackResource /r.php. Abra um endereço que não existe: se aparecer a página de erro do Moodle, o roteador funciona. Mais em Moodle em branco ou 404: a pasta public.
• "localhost redirected you too many times". O Moodle só atende pelo endereço gravado em $CFG->wwwroot, no config.php. Se você abre por outro (127.0.0.1 em vez de localhost, outra porta, http em vez de https), ele redireciona para o gravado, e o navegador desiste se a volta nunca termina. Ajuste o valor para o que você usa, como $CFG->wwwroot = 'http://localhost';, e limpe os cookies.
• Tela em branco. Veja o log de erros do Apache e Moodle com erro 500.

Primeiros passos para aprender o Moodle

• Um curso de teste. Crie uma categoria e um curso em Administração do site > Cursos, como em como criar um curso no Moodle.
• Um professor e um aluno de teste. Em Administração do site > Usuários > Contas, crie dois usuários e inscreva cada um no curso com o seu papel.
• Veja o curso como aluno. O menu do usuário permite trocar de papel, mas você continua sendo o mesmo usuário e a visão não é perfeita, diz a documentação. Para testar de verdade, entre com o aluno de teste em outro navegador.
• As atividades principais. Tarefa, fórum, questionário e H5P para conteúdo interativo.
• Conclusão e relatórios. Configure a conclusão das atividades e do curso e veja o resultado em relatórios no Moodle.

Alternativas sem instalar

O Moodle mantém dois sites de demonstração: o Mount Orange University (school.moodledemo.net), com cursos e usuários, e o Moodle Sandbox (sandbox.moodledemo.net), vazio, para testar os recursos padrão. Ambos são reiniciados a cada hora e apagam o que você criar. Para guardar o trabalho, a página de download anuncia um teste gratuito de 28 dias no MoodleCloud, sem cartão de crédito (confira as condições ao se cadastrar).

Quando não vale instalar sozinho

Local é para aprender. Para colocar colaboradores ou alunos num Moodle de verdade, entram servidor Linux, cron, backup e atualização. Fazemos a instalação do Moodle com as versões certas, damos a capacitação em Moodle para a sua equipe e temos hospedagem de Moodle gerenciada.

Leia também: Moodle app para PC e Windows: existe?

Perguntas frequentes