---
title: "Utilisation"
weight: 35
description: "Guide pas à pas pour cloner un Dolibarr de production vers un serveur de test avec DoliClone."
---

# Utilisation

Ce guide décrit le processus complet de clonage d'un Dolibarr de production vers un serveur de destination.

## Vue d'ensemble

Le processus de clonage comprend trois phases :

1. **Préparation du serveur source** -- Configuration du module DoliClone et génération de la sauvegarde SQL
2. **Déploiement de l'installeur** -- Installation de l'installeur autonome sur le serveur de destination
3. **Exécution du clonage** -- Lancement du transfert et configuration post-clonage

## Phase 1 : Préparation du serveur source

### Étape 1 : Activer le module

Activez le module DoliClone sur votre Dolibarr de production (voir [Installation](/view.php?path=doliclone/installation.md)).

### Étape 2 : Vérifier la clé API

Assurez-vous que votre utilisateur administrateur dispose d'une clé API. Si le champ est vide, un avertissement est affiché sur la page de configuration.

### Étape 3 : Configurer la sauvegarde

1. Accédez à **Accueil > Configuration > Modules > DoliClone**
2. Sélectionnez la méthode de sauvegarde **Système DoliClone**
3. Renseignez l'adresse IP publique du serveur de destination dans le champ **Adresses IP autorisées**
4. Enregistrez

### Étape 4 : Lancer une première sauvegarde

Cliquez sur **Lancer la sauvegarde SQL** pour générer la première sauvegarde de la base de données. Vérifiez que le message de confirmation apparaît.

### Étape 5 : Notez les informations de connexion

Relevez les deux informations affichées en lecture seule :

- **Adresse de ce serveur source** -- L'URL de l'API
- **Clé de sécurité** -- La clé API de l'utilisateur

![Informations de connexion du serveur source à copier sur le serveur de destination](screenshots/utilisation-informations-connexion.webp)

## Phase 2 : Déploiement sur le serveur de destination

### Étape 6 : Télécharger l'installeur

Sur la page de configuration DoliClone du serveur source, cliquez sur **Télécharger l'installeur** dans la section dédiée.

### Étape 7 : Déployer l'installeur

1. Transférez le fichier ZIP sur le serveur de destination
2. Décompressez-le dans un répertoire accessible par le serveur web
3. Accédez à l'URL correspondante dans votre navigateur

### Étape 8 : Configurer la connexion

Sur la page de l'installeur, renseignez :

- L'adresse de synchronisation (URL de l'API du serveur source)
- La clé d'accès à l'API
- Les informations de connexion à la base de données locale

## Phase 3 : Exécution du clonage

### Étape 9 : Choisir les éléments à cloner

Cochez les options souhaitées :

- **Cloner la base de données** -- Indispensable pour un premier clonage
- **Télécharger les documents** -- Recommandé pour disposer de tous les fichiers
- **Télécharger les modules** -- Recommandé pour avoir les mêmes modules qu'en production

### Étape 10 : Choisir les actions post-clonage

- **Désactiver le mode production de Stancer** -- Cochez si vous utilisez Stancer pour les paiements CB
- **Anonymiser les données** -- Cochez si le serveur de destination est utilisé pour des tests ou des démonstrations

### Étape 11 : Lancer le clonage

Cliquez sur **Lancer la synchronisation**. La progression s'affiche en temps réel pour chaque étape.

### Étape 12 : Modifier le 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` :

```
$dolibarr_main_instance_unique_id = 'VALEUR_AFFICHEE';
$dolibarr_main_db_prefix = 'PREFIXE_AFFICHE';
```

> **Très important** : Sauvegardez les informations affichées avant de cliquer sur le lien pour basculer sur le Dolibarr cloné. Sans la modification du fichier `conf.php`, aucune donnée chiffrée ne pourra être déchiffrée.

### Étape 13 : Accéder au Dolibarr cloné

Une fois le fichier `conf.php` modifié, cliquez sur le lien **J'ai sauvegardé cette page et je veux aller sur le Dolibarr cloné**. Vous accédez alors à votre Dolibarr de test avec les données de production.

## Indicateur sur la page de connexion

Après le clonage, la page de connexion Dolibarr affiche automatiquement un indicateur précisant si vous êtes sur le Dolibarr original ou sur le Dolibarr cloné. Ce bandeau indique également la valeur du préfixe à utiliser dans `conf.php` pour basculer entre les deux bases.

![Page de connexion Dolibarr avec l'indicateur DoliClone affichant l'état du serveur (original ou cloné)](screenshots/utilisation-indicateur-login.webp)

## Resynchronisation

Pour mettre à jour le clone avec les dernières données de production :

1. Déverrouillez l'installeur (supprimez `install.lock` ou utilisez le token de sécurité)
2. Relancez la synchronisation avec les options souhaitées

Les fichiers déjà présents et identiques (vérification MD5) ne sont pas retéléchargés, ce qui accélère les synchronisations suivantes.