---
title: "Installation"
weight: 10
description: "Téléchargement, installation, activation et mise à jour du module SmartInterventions pour Dolibarr."
---

# Installation

## Téléchargement

Téléchargez le module depuis le [DoliStore](https://www.dolistore.com/) ou depuis votre espace client CAP-REL.

## Installation du module

1. Connectez-vous en tant qu'administrateur Dolibarr
2. Allez dans **Accueil > Configuration > Modules/Applications > Déployer/Installer un module externe**
3. Téléversez l'archive zip du module
4. Dolibarr extrait et installe automatiquement le module

## Prérequis

Avant d'activer SmartInterventions, vérifiez que les modules Dolibarr suivants sont activés :

| Module | Rôle |
|--------|------|
| Tiers | Gestion des clients liés aux interventions |
| Interventions (Fichinter) | Module natif de fiches d'intervention |
| Produits | Catalogue de produits |
| Services | Catalogue de services |
| Tâches planifiées (Cron) | Traitements automatisés |
| Facturation | Gestion des factures |
| ECM (GED) | Gestion électronique des documents et photos |
| SmartAuth | Authentification pour l'application smartphone |

> **Attention** : le module SmartAuth est indispensable pour l'authentification des techniciens sur l'application smartphone. Il doit être installé et activé avant SmartInterventions.

## Activation

1. Connectez-vous en tant qu'administrateur Dolibarr
2. Allez dans **Accueil > Configuration > Modules/Applications**
3. Recherchez "SmartInterventions" dans la liste
4. Cliquez sur le bouton d'activation

![Page d'activation du module SmartInterventions dans la liste des modules Dolibarr](screenshots/activation-module.webp)

À l'activation, le module :

- Crée les tables nécessaires en base de données (statuts, schémas, profils)
- Crée la table satellite des données métier de l'intervention (date prévue, durée planifiée, envoi automatique au client, type d'intervention, type d'événement, urgence, adresse, état avancé) : ce sont des **colonnes natives** de cette table, plus des extrafields (les 8 anciens extrafields d'intervention sont migrés vers ces colonnes à l'activation)
- Ajoute les champs photo extensibles (`smartphoto_*`) sur les fiches d'intervention
- Génère une clé JWT pour l'authentification de l'application smartphone

## Hôte virtuel ou proxy dédié (obligatoire)

Pour des raisons de sécurité et de bon fonctionnement de l'application smartphone, l'application **doit** être accessible à la racine d'un sous-domaine dédié. Deux solutions au choix, l'une ou l'autre étant impérative :

- un **hôte virtuel** dédié sur votre serveur web (voir l'exemple ci-dessous) ;
- un **proxy** dédié, par exemple le service [DoliProxy](https://doliproxy.fr) proposé par CAP-REL.

Dans les deux cas, l'application est servie à la racine d'un sous-domaine (par exemple `https://interventions.votre-domaine.fr/`) et non dans un sous-répertoire. Une fois le sous-domaine en place, renseignez son adresse dans l'onglet **Généralités** de la configuration du module.

```apache
<VirtualHost *:443>
    ServerName interventions.votre-domaine.fr
    DocumentRoot /var/www/dolibarr/htdocs/custom/smartinterventions/pwa

    <Directory /var/www/dolibarr/htdocs/custom/smartinterventions/pwa>
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>
```

## Taille maximale des fichiers uploadés

L'application smartphone envoie des photos et des signatures depuis le terrain.
Si la taille maximale d'upload autorisée par votre serveur est trop basse, ces
envois peuvent échouer (photo qui ne remonte pas, signature non enregistrée),
en particulier pour les photos haute résolution ou lorsque plusieurs photos sont
jointes à une même intervention.

Cette limite est fixée par la configuration de PHP (`upload_max_filesize`,
`post_max_size`) et parfois du serveur web (Apache, Nginx), pas par le module
lui-même. Le réglage est commun à tous les modules et à Dolibarr dans son
ensemble.

La procédure détaillée pour augmenter cette limite est mutualisée ici :
[Augmenter la taille maximale des fichiers](https://doc.cap-rel.fr/dolibarr/taille-fichiers).

## Mise à jour

1. Téléversez la nouvelle version via **Accueil > Configuration > Modules/Applications > Déployer/Installer un module externe**
2. Désactivez puis réactivez le module pour appliquer les mises à jour de base de données et enregistrer les nouveaux hooks et permissions

## Désinstallation

Désactivez le module depuis **Accueil > Configuration > Modules/Applications**. Les données créées par le module (table satellite des interventions, tables de schémas) sont conservées en base de données.