Installeur autonome

L'installeur autonome est une application web légère que vous déployez sur le serveur de destination. Il se connecte au serveur source via l'API REST pour télécharger et restaurer la base de données, les documents et les modules.

Téléchargement

Sur le serveur source, accédez à Accueil > Configuration > Modules > DoliClone
Dans la section Télécharger l'installeur client, cliquez sur Télécharger l'installeur
Un fichier ZIP est généré et téléchargé

Déploiement sur le serveur de destination

Transférez le fichier ZIP sur votre serveur de destination
Décompressez-le dans le répertoire web de votre choix (par exemple /var/www/doliclone/)
Rendez le dossier accessible via un navigateur (configurez un hôte virtuel Apache ou Nginx)

Le dossier extrait contient :

index.php -- Page principale de l'installeur
doliclonealone.class.php -- Classe de gestion du clonage
doliclonealone.lib.php -- Fonctions utilitaires
security.inc.php -- Gestion de la sécurité (verrouillage, tokens)
copy.php, sql.php, core.php, fake.php -- Endpoints AJAX pour les différentes étapes
verify.php -- Vérification d'intégrité des fichiers SQL
sync.php -- Endpoint de synchronisation automatique
dashboard.php -- Tableau de bord des synchronisations
zipdownload.php -- Gestion des transferts par ZIP
progress.php -- Suivi de progression
assets/ -- Fichiers CSS et JavaScript de l'interface

Configuration initiale

Lors du premier accès à l'installeur, vous devez fournir les informations suivantes :

Connexion au serveur source

Champ	Description
Adresse de synchronisation	L'URL de l'API REST affichée sur la page de configuration DoliClone du serveur source
Clé d'accès à l'API	La clé de sécurité affichée sur la page de configuration DoliClone du serveur source

Base de données locale

Champ	Description
Serveur de base de données	Adresse du serveur MySQL/MariaDB (généralement `localhost`)
Nom de la base de données	Nom de la base qui recevra les données clonées
Identifiant	Nom d'utilisateur MySQL
Mot de passe	Mot de passe MySQL

Attention : Le choix de la configuration n'est possible qu'une seule fois. Vérifiez soigneusement les paramètres avant de valider.

Écran de configuration initiale de l'installeur autonome avec les champs de connexion au serveur source et à la base de données locale

Sécurité

L'installeur génère un token de sécurité lors de la première utilisation. Ce token est stocké dans le fichier security.token et doit être conservé précieusement.

Verrouillage automatique

Après une synchronisation réussie, l'installeur se verrouille automatiquement (fichier install.lock). Pour le déverrouiller :

Supprimez le fichier install.lock via SSH
Ou saisissez le token de sécurité sur la page de verrouillage

Filtrage par IP

Sur le serveur source, renseignez l'adresse IP publique du serveur de destination dans le champ Adresses IP autorisées de la configuration DoliClone.

Lancement du clonage

Une fois la configuration validée, l'installeur affiche les options de clonage :

Éléments à cloner

Option	Description
Cloner la base de données	Télécharge et restaure la sauvegarde SQL table par table
Télécharger les documents	Copie l'intégralité des fichiers du dossier `documents/` (PDF, pièces jointes, etc.)
Télécharger les modules	Copie tous les modules complémentaires du dossier `htdocs/custom/`

Actions post-clonage

Option	Description
Désactiver le mode production de Stancer	Désactive le mode production du module de paiement par carte bancaire Stancer
Anonymiser les données	Remplace les données personnelles par des données fictives (conformité RGPD)

Écran de lancement du clonage avec les cases à cocher des éléments à cloner et les options post-clonage

Déroulement du clonage

Le clonage se déroule en plusieurs étapes affichées en temps réel :

Copie de la base de données -- Téléchargement des fichiers SQL depuis le serveur source, puis restauration table par table dans la base locale
Copie des documents -- Téléchargement fichier par fichier avec vérification MD5 (les fichiers identiques ne sont pas retéléchargés)
Copie des modules -- Téléchargement des modules complémentaires

Chaque étape affiche sa progression et un message de confirmation à la fin.

Durée : Le premier clonage peut prendre un temps significatif selon la taille de votre base de données et le nombre de documents. Les synchronisations suivantes sont plus rapides grâce à la vérification MD5.

Transfert par ZIP

Pour les premiers déploiements avec un grand volume de données, le mode de transfert par ZIP est plus rapide. L'installeur vérifie automatiquement si le serveur source supporte le streaming ZIP et propose ce mode le cas échéant.

Les modules et les dossiers de documents sont alors téléchargés sous forme d'archives ZIP, puis décompressés localement.

Après le clonage

Modification du fichier conf.php

Après la restauration de la base de données, l'installeur affiche les valeurs à reporter dans le fichier htdocs/conf/conf.php du Dolibarr cloné :

$dolibarr_main_instance_unique_id -- Identifiant unique de l'instance
$dolibarr_main_db_prefix -- Préfixe des tables de la base clonée

Très important : Sans cette modification, les données chiffrées de la base de données ne pourront pas être déchiffrées et vous resterez connecté à la base d'origine.

Installation du coeur Dolibarr

Si le serveur de destination ne dispose pas encore de Dolibarr, l'installeur propose de télécharger et d'installer automatiquement la version correspondante depuis GitHub.

Tableau de bord

La page dashboard.php affiche les statistiques des synchronisations :

Nombre total de synchronisations effectuées
Nombre de fichiers synchronisés
Nombre d'erreurs rencontrées
Synchronisations en cours

Tableau de bord de l'installeur DoliClone avec les statistiques de synchronisation et l'historique des opérations