---
title: "Installeur autonome"
weight: 30
description: "Déploiement et utilisation de l'installeur autonome sur le serveur de destination pour cloner votre Dolibarr."
---

# 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

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

## Déploiement sur le serveur de destination

1. Transférez le fichier ZIP sur votre serveur de destination
2. Décompressez-le dans le répertoire web de votre choix (par exemple `/var/www/doliclone/`)
3. 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](screenshots/installeur-configuration-initiale.webp)

## 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](screenshots/installeur-lancement-clonage.webp)

## Déroulement du clonage

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

1. **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
2. **Copie des documents** -- Téléchargement fichier par fichier avec vérification MD5 (les fichiers identiques ne sont pas retéléchargés)
3. **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](screenshots/installeur-tableau-de-bord.webp)