---
title: "Aggiornare, fare backup, traslocare"
description: "Come aggiornare Éclair senza rischi, fare il backup del tuo sito in un clic, ripristinarlo e traslocarlo su un altro hosting o un altro dominio."
url: "https://eclaircms.org/it/documentazione/aggiornamenti"
lang: "it"
author: "Thierry Gustin"
published: "2026-10-30"
updated: "2026-11-01"
---

# Aggiornare, fare backup, traslocare

> **In breve** — Per aggiornare Éclair: scarica un backup, elimina via FTP le cartelle app/ e assets/, carica quelle della nuova versione con index.php e .htaccess, senza toccare data/ né media/, poi svuota la cache. Il backup è un archivio ZIP di data/ e media/, da ripristinare sostituendo queste due cartelle.

Aggiornare Éclair richiede cinque minuti e non tocca mai i tuoi contenuti: vivono in cartelle che l’aggiornamento lascia intatte. Questa guida spiega anche come fare il backup del sito in un clic, ripristinarlo e traslocarlo su un altro hosting o un altro dominio, senza perdere una pagina né il tuo posizionamento.

## Come fare il backup del tuo sito?

In **Sicurezza › Backup**, clicca su **Scarica un backup**. Ricevi un archivio ZIP che contiene due cartelle:

| Cartella | Cosa contiene |
| --- | --- |
| `data/` | I tuoi contenuti e le loro versioni, le impostazioni, gli account, i menu, le categorie e i messaggi |
| `media/` | Tutte le tue immagini e le loro versioni WebP |

Per sicurezza, le chiavi API dell’assistente IA, la cronologia delle sue conversazioni, le sessioni e i contatori di accesso sono esclusi dall’archivio. Se il tuo provider non ha l’estensione zip, copia semplicemente le cartelle `data/` e `media/` via FTP.

> **Quando fare il backup?** — Prima di ogni modifica importante e prima di ogni aggiornamento. Un backup al mese resta una buona abitudine, anche senza cambiare nulla: conservalo sul tuo computer o nel tuo spazio di archiviazione online.

Se hai effettuato l’accesso più di 15 minuti fa, Éclair ti chiede di nuovo la password prima di creare l’archivio.

## Come ripristinare un backup?

1. Decomprimi l’archivio sul tuo computer: contiene `data/`, `media/` e un file `LISEZ-MOI.txt` (in francese, «leggimi»).
2. Via FTP, sostituisci le cartelle `data/` e `media/` della tua installazione con quelle dell’archivio.
3. Accedi, poi vai in **Impostazioni › Avanzate › Svuota la cache**.
4. Se usi l’assistente IA, incolla di nuovo le tue chiavi API in Impostazioni › Assistente IA: non fanno parte dei backup.

## Come aggiornare Éclair a una nuova versione?

Consulta prima il [registro delle versioni](https://eclaircms.org/it/changelog) per vedere cosa cambia, poi scarica il nuovo archivio dalla pagina [Scarica](https://eclaircms.org/it/scarica).

1. **Fai un backup** da Sicurezza › Backup.
2. Via FTP, **elimina** le cartelle `app/` e `assets/` del tuo sito.
3. **Carica** quelle della nuova versione, insieme a `index.php` e `.htaccess`.
4. **Non toccare** `data/` (contenuti, impostazioni, account) né `media/` (immagini).
5. Nell’amministrazione, clicca su **Impostazioni › Avanzate › Svuota la cache**.

Eliminare prima di caricare evita di conservare vecchi file ormai inutili, che il controllo di integrità segnalerebbe. Per finire, avvia **Sicurezza › Integrità dei file › Analizza ora**: tutto deve essere verde.

> **Tema personalizzato** — Se hai modificato i template di `app/theme/` o il file `theme.css`, l’aggiornamento li sostituisce con quelli originali. Conserva una copia dei tuoi file personalizzati e ricaricali dopo l’aggiornamento, poi svuota la cache. Il controllo di integrità li segnalerà come modificati: è normale.

## Come traslocare su un altro hosting?

1. Scarica un backup, poi copia **l’intera cartella** del sito via FTP, file nascosti `.htaccess` compresi.
2. Caricala presso il tuo nuovo provider, nella cartella pubblica del dominio. Verifica che PHP sia in versione 8.1 o successiva (consigliata la 8.3).
3. Fai puntare il tuo dominio al nuovo hosting, poi attendi la propagazione DNS (da qualche minuto a qualche ora).
4. Accedi e clicca su **Sicurezza › Verifica l’indirizzo del sito**.

Nessun database da esportare né da reimportare: è uno dei grandi vantaggi di un [CMS senza database](https://eclaircms.org/blog/cms-senza-database).

## Come cambiare nome di dominio?

Dopo aver copiato il sito, cambia l’indirizzo in **Impostazioni › Generali › Indirizzo ufficiale del sito**, poi verificalo nella pagina Sicurezza. I link interni si adattano automaticamente, anche se il sito è installato in una sottocartella. La sitemap, gli URL canonici e `llms.txt` usano subito il nuovo indirizzo.

Se il vecchio dominio resta attivo, reindirizzalo con un 301 al nuovo presso il tuo provider: i tuoi visitatori e il tuo posizionamento seguiranno. Ricordati anche di dichiarare il cambio di indirizzo in Google Search Console, come spiega la [guida di Google ai trasferimenti di sito](https://developers.google.com/search/docs/crawling-indexing/site-move-with-url-changes).

## Si possono tenere i dati fuori dalla cartella pubblica?

Sì, se il tuo provider lo consente. Sposta prima la cartella `data/` nella posizione scelta, poi copia il file `eclair-config.exemple.php` con il nome `eclair-config.php`, accanto a `index.php`, e indica il nuovo percorso:

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

// Dati conservati fuori dalla cartella pubblica.
define('ECLAIR_DATA', '/home/miaccount/eclair-data');
```

I tuoi dati sono già protetti due volte nella cartella pubblica. Questa opzione aggiunge una terza barriera: non si trovano più nemmeno nell’albero del sito.

## Bisogna svuotare la cache dopo ogni modifica?

No. La cache statica si svuota da sola a ogni modifica fatta nell’amministrazione, e all’ora prevista per un articolo programmato. Svuotala a mano solo dopo un aggiornamento o una modifica dei file via FTP, in Impostazioni › Avanzate › Svuota la cache. Il pulsante **Ricostruisci l’indice e svuota la cache** della pagina Sicurezza ripara anche l’indice dei contenuti, in caso di bisogno.

## Domande sull’aggiornamento

### L’aggiornamento cancella i miei contenuti?

No. I tuoi contenuti, le impostazioni e gli account sono in data/, le tue immagini in media/: la procedura chiede appunto di non toccare queste due cartelle.

### Quanto tempo ci vuole per aggiornare Éclair?

Circa cinque minuti: un backup, l’eliminazione e il caricamento di due cartelle (meno di 1 MB), poi un clic per svuotare la cache.

### Il mio backup contiene le mie chiavi API?

No. Le chiavi dell’assistente IA e la cronologia delle sue conversazioni sono volutamente escluse. Dopo un ripristino, incolla di nuovo le tue chiavi in Impostazioni › Assistente IA.

### Il sito va offline durante l’aggiornamento?

Solo il tempo di caricare app/ e assets/, in genere meno di un minuto. Le pagine già in cache continuano a essere servite grazie al file index.php.