--- title: "Experimentar no seu computador" description: "Instalar o Éclair localmente para testar de graça: com XAMPP, MAMP ou Laragon em 5 minutos, ou com o servidor embutido do PHP, e depois colocar no ar." url: "https://eclaircms.org/pt/instalacao/local" lang: "pt" author: "Thierry Gustin" published: "2026-10-30" updated: "2026-11-01" --- # Experimentar no seu computador > **O essencial** — Para instalar o Éclair localmente, copie a pasta eclair para a pasta web de um servidor local como XAMPP, MAMP ou Laragon (por exemplo, htdocs/eclair), abra http://localhost/eclair/ e responda às 4 perguntas do assistente. Desenvolvedores também podem usar o servidor embutido do PHP com o roteador do repositório no GitHub. Para publicar o site, basta copiar a pasta inteira para a sua hospedagem. Quer conhecer o Éclair antes de escolher uma hospedagem, ou preparar seu site com calma, offline? Você pode instalar o Éclair localmente, no seu computador, em 5 minutos. Basta um pequeno servidor web com PHP: XAMPP, MAMP ou Laragon, se você não é desenvolvedor, ou o servidor embutido do PHP, se é. Depois, seu site poderá ser publicado do jeito que está. ## Que solução escolher para instalar o Éclair localmente? | Ferramenta | Sistemas | Para quem? | | --- | --- | --- | | [XAMPP](https://www.apachefriends.org/) | Windows, macOS, Linux | O mais difundido, gratuito, com Apache e PHP | | [MAMP](https://www.mamp.info/) | macOS, Windows | Muito simples no Mac, a versão gratuita basta | | [Laragon](https://laragon.org/) | Windows | Leve e rápido, apreciado por desenvolvedores | | Servidor embutido do PHP | Todos | Desenvolvedores à vontade com o terminal | Os três primeiros instalam Apache e PHP em poucos cliques: é exatamente o ambiente de uma hospedagem compartilhada, `.htaccess` incluído. Só confira se a versão do PHP oferecida é **8.1 ou superior**. ## Como instalar o Éclair localmente com o XAMPP? 1. Instale o [XAMPP](https://www.apachefriends.org/), abra o painel de controle e inicie o **Apache** (o MySQL é desnecessário). 2. [Baixe o Éclair](https://eclaircms.org/pt/baixar) e descompacte o arquivo ZIP. 3. Copie a pasta `eclair` para a pasta web do XAMPP: `C:\xampp\htdocs\` no Windows, `/Applications/XAMPP/htdocs/` no Mac. 4. Abra `http://localhost/eclair/` no navegador: o assistente de instalação começa. 5. Responda às 4 perguntas, como explicado no [guia de instalação](https://eclaircms.org/pt/instalacao). No MAMP, a pasta web também se chama `htdocs`, e o endereço depende da porta escolhida (por exemplo, `http://localhost:8888/eclair/`). No Laragon, coloque a pasta em `C:\laragon\www\` e abra `http://localhost/eclair/`. > **Um aviso de HTTPS é normal** — No ambiente local, o site abre em `http://`, então o assistente mostra um ponto laranja no item de HTTPS. Isso não bloqueia nada. Quando o site estiver no ar, sua hospedagem fornecerá um certificado gratuito. > **Instalado em uma subpasta? Nenhum ajuste necessário** — O Éclair detecta sozinho que está em `/eclair/`: os links, as imagens e a administração se adaptam automaticamente, tanto no ambiente local quanto no ar. ## E com o servidor embutido do PHP? Para desenvolvedores: o repositório do Éclair no GitHub contém um roteador que reproduz as regras do `.htaccess` para o servidor embutido do PHP. É preciso ter PHP 8.1 ou superior e o Git. ```bash git clone https://github.com/Jacckisback/eclair-cms.git cd eclair-cms PHP_CLI_SERVER_WORKERS=4 php -S localhost:8000 -t eclair tools/router.php ``` Depois, abra `http://localhost:8000`. A variável `PHP_CLI_SERVER_WORKERS` permite que o site chame a si mesmo para verificar o próprio endereço: com um único processo, essa verificação simplesmente falha, sem atrapalhar o resto. O mesmo repositório contém os testes (`php tests/run.php`, 550 verificações): tudo está detalhado na [página para desenvolvedores](https://eclaircms.org/pt/documentacao/desenvolvedores). ## Como colocar no ar o site preparado localmente? Seu site cabe em uma única pasta: basta copiá-la. 1. Na administração local, baixe um backup por segurança (**Segurança › Baixar backup**). 2. Envie **todo** o conteúdo da pasta `eclair` para a sua hospedagem, incluindo as pastas `data` e `media`, com os arquivos ocultos `.htaccess`. 3. Entre na administração online com o mesmo e-mail e a mesma senha. 4. Em **Configurações › Geral**, troque o endereço local pelo endereço definitivo do site (por exemplo, `https://seu-site.com.br`). 5. Em **Segurança**, clique em **Verificar endereço do site** e depois limpe o cache em **Configurações › Avançado**. Os links internos se adaptam automaticamente, mesmo que o seu site passe de uma subpasta local para a raiz de um domínio. Se a sua hospedagem for a o2switch, siga o [guia da o2switch](https://eclaircms.org/pt/instalacao/o2switch) a partir da etapa 4. ## Perguntas sobre a instalação local ### Preciso instalar o MySQL para testar o Éclair localmente? Não. O Éclair não precisa de nenhum banco de dados: inicie apenas o Apache no XAMPP, no MAMP ou no Laragon. O módulo MySQL pode ficar desligado. ### Posso instalar o Éclair localmente sem conexão com a internet? Sim, depois que o Éclair estiver baixado. Só o assistente de IA, o IndexNow e o envio de e-mails precisam de internet; todo o resto funciona offline. ### Meu site local aparecerá no Google? Não. Um site aberto em `http://localhost` só pode ser acessado a partir do seu computador. Ele se torna público depois de copiado para uma hospedagem. ### O assistente mostra “Instalação bloqueada”: o que fazer? A janela de 2 horas depois da primeira visita passou. Apague o arquivo `data/install-window.php` na pasta do Éclair e recarregue a página. [Baixar o Éclair 1.8.0](https://eclaircms.org/pt/baixar)