---
title: "Atualizar, fazer backup, mudar de hospedagem"
description: "Como atualizar o Éclair sem risco, fazer backup do seu site com um clique, restaurá-lo e mudá-lo para outra hospedagem ou para outro domínio."
url: "https://eclaircms.org/pt/documentacao/atualizacoes"
lang: "pt"
author: "Thierry Gustin"
published: "2026-10-30"
updated: "2026-11-01"
---

# Atualizar, fazer backup, mudar de hospedagem

> **O essencial** — Para atualizar o Éclair: baixe um backup, apague as pastas app/ e assets/ por FTP, envie as da nova versão com index.php e .htaccess, sem mexer em data/ nem em media/, e depois limpe o cache. O backup é um arquivo ZIP de data/ e media/, que você restaura substituindo essas duas pastas.

Atualizar o Éclair leva cinco minutos e nunca mexe nos seus conteúdos: eles ficam em pastas que a atualização deixa intactas. Este guia também explica como fazer backup do seu site com um clique, restaurá-lo e mudá-lo para outra hospedagem ou outro domínio, sem perder nenhuma página nem o seu posicionamento.

## Como fazer backup do seu site?

Em **Segurança › Backup**, clique em **Baixar backup**. Você recebe um arquivo ZIP com duas pastas:

| Pasta | O que ela contém |
| --- | --- |
| `data/` | Seus conteúdos, as versões deles, suas configurações, as contas, os menus, as categorias e as mensagens |
| `media/` | Todas as suas imagens e as versões WebP delas |

Por segurança, as chaves de API do assistente de IA, o histórico das conversas, as sessões e os contadores de login ficam fora do arquivo. Se a extensão zip não existir na sua hospedagem, copie simplesmente as pastas `data/` e `media/` por FTP.

> **Quando fazer backup?** — Antes de cada grande alteração e antes de cada atualização. Um backup por mês continua sendo um bom hábito, mesmo sem mudar nada: guarde-o no seu computador ou no seu espaço de armazenamento online.

Se você fez login há mais de 15 minutos, o Éclair pede sua senha de novo antes de criar o arquivo.

## Como restaurar um backup?

1. Descompacte o arquivo no seu computador: ele contém `data/`, `media/` e um arquivo `LISEZ-MOI.txt` (em francês, “leia-me”).
2. Por FTP, substitua as pastas `data/` e `media/` da sua instalação pelas do arquivo.
3. Faça login e vá em **Configurações › Avançado › Limpar cache**.
4. Se você usa o assistente de IA, cole de novo suas chaves de API em Configurações › Assistente de IA: elas não fazem parte dos backups.

## Como atualizar o Éclair para uma nova versão?

Consulte primeiro o [changelog](https://eclaircms.org/pt/changelog) para ver o que muda e depois baixe o novo arquivo na página [Baixar](https://eclaircms.org/pt/baixar).

1. **Faça um backup** em Segurança › Backup.
2. Por FTP, **apague** as pastas `app/` e `assets/` do seu site.
3. **Envie** as da nova versão, com `index.php` e `.htaccess`.
4. **Não mexa** em `data/` (conteúdos, configurações, contas) nem em `media/` (imagens).
5. Na administração, clique em **Configurações › Avançado › Limpar cache**.

Apagar antes de enviar evita manter arquivos antigos que se tornaram inúteis, que a verificação de integridade sinalizaria. Para terminar, execute **Segurança › Integridade dos arquivos › Analisar agora**: tudo deve ficar verde.

> **Tema personalizado** — Se você modificou os templates de `app/theme/` ou o arquivo `theme.css`, a atualização os substitui pelos originais. Guarde uma cópia dos seus arquivos personalizados e envie-os de novo depois da atualização, e então limpe o cache. A verificação de integridade vai apontá-los como modificados: é normal.

## Como mudar para outra hospedagem?

1. Baixe um backup e depois copie **a pasta inteira** do site por FTP, incluindo os arquivos ocultos `.htaccess`.
2. Envie-a para a nova hospedagem, na pasta pública do domínio. Confira se o PHP está na versão 8.1 ou superior (8.3 recomendado).
3. Aponte o seu domínio para a nova hospedagem e depois espere a propagação do DNS (de alguns minutos a algumas horas).
4. Faça login e clique em **Segurança › Verificar endereço do site**.

Não há banco de dados para exportar nem reimportar: é uma das grandes vantagens de um [CMS sem banco de dados](https://eclaircms.org/blog/cms-sem-banco-de-dados).

## Como mudar de nome de domínio?

Depois de copiar o site, altere o endereço em **Configurações › Geral › Endereço oficial do site** e depois verifique-o na página Segurança. Os links internos se adaptam automaticamente, inclusive se o site estiver instalado em uma subpasta. O sitemap, as URLs canônicas e o `llms.txt` passam a usar o novo endereço na hora.

Se o domínio antigo continuar ativo, redirecione-o com um 301 para o novo na sua hospedagem: seus visitantes e seu posicionamento vão junto. Lembre-se também de informar a mudança de endereço no Google Search Console, como explica o [guia do Google sobre mudanças de site](https://developers.google.com/search/docs/crawling-indexing/site-move-with-url-changes).

## Dá para guardar os dados fora da pasta pública?

Sim, se a sua hospedagem permitir. Mova primeiro a pasta `data/` para o local escolhido, depois copie o arquivo `eclair-config.exemple.php` com o nome `eclair-config.php`, ao lado do `index.php`, e informe o novo caminho:

```php
<?php
defined('ECLAIR') || exit;

// Dados guardados fora da pasta pública.
define('ECLAIR_DATA', '/home/minhaconta/eclair-data');
```

Seus dados já estão protegidos duas vezes dentro da pasta pública. Esta opção acrescenta uma terceira barreira: eles deixam até de fazer parte da estrutura do site.

## É preciso limpar o cache a cada alteração?

Não. O cache estático se limpa sozinho a cada alteração feita na administração e no horário previsto para um artigo agendado. Limpe-o à mão só depois de uma atualização ou de uma alteração de arquivos por FTP, em Configurações › Avançado › Limpar cache. O botão **Reconstruir o índice e limpar o cache** da página Segurança também repara o índice dos conteúdos, se for preciso.

## Perguntas sobre a atualização

### A atualização apaga meus conteúdos?

Não. Seus conteúdos, configurações e contas estão em data/, e suas imagens em media/: o procedimento pede justamente para não mexer nessas duas pastas.

### Quanto tempo leva para atualizar o Éclair?

Cerca de cinco minutos: um backup, a exclusão e o envio de duas pastas (menos de 1 MB) e um clique para limpar o cache.

### Meu backup contém as minhas chaves de API?

Não. As chaves do assistente de IA e o histórico das conversas ficam de fora de propósito. Depois de uma restauração, cole as chaves de novo em Configurações › Assistente de IA.

### O site fica fora do ar durante a atualização?

Só o tempo de enviar app/ e assets/, em geral menos de um minuto. As páginas que já estão em cache continuam sendo servidas graças ao arquivo index.php.