---
title: "Installation"
weight: 10
description: "Téléchargement, installation, activation et mise à jour du module SmartPOS 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. Décompressez l'archive téléchargée
2. Copiez le dossier `smartpos` dans le répertoire `htdocs/custom/` de votre installation Dolibarr
3. Installez les dépendances Composer :

    ```bash
    cd htdocs/custom/smartpos
    composer install --no-dev
    ```

## Activation

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

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

Le module crée automatiquement les tables nécessaires en base de données et les répertoires de travail.

## Hôte virtuel pour l'application mobile

L'interface de vente SmartPOS est une application PWA (Progressive Web App) servie depuis le dossier `mobile/dist/`. Pour un fonctionnement optimal, créez un hôte virtuel Apache dédié :

```apache
<VirtualHost *:443>
    ServerName pos.votre-domaine.fr
    DocumentRoot /var/www/dolibarr/htdocs/custom/smartpos/mobile/dist

    <Directory /var/www/dolibarr/htdocs/custom/smartpos/mobile/dist>
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>
```

Configurez ensuite la variable d'environnement `VITE_API_URL` pour pointer vers l'URL de l'API SmartPOS (par exemple `https://erp.votre-domaine.fr/custom/smartpos/pwa/api.php/`).

## Premier paramétrage

Après activation, rendez-vous dans le menu **SmartPOS** qui apparaît dans la barre de navigation Dolibarr. L'onglet **Paramètres** vous permet de configurer :

1. **Le client par défaut** -- Client Dolibarr utilisé quand aucun client n'est sélectionné sur le terminal. Ce paramètre est recommandé pour éviter les erreurs à la facturation.
2. **Le mode de déduction du stock** -- Choisissez si le stock est déduit au moment de la commande ou au moment de la facturation.

![Écran de paramétrage général SmartPOS avec le client par défaut et le mode de déduction du stock](screenshots/parametrage-general.webp)

## Attribution des permissions

Rendez-vous dans **Accueil > Utilisateurs et groupes** pour attribuer les permissions SmartPOS à vos utilisateurs. Les permissions disponibles sont détaillées dans la page [Configuration](/view.php?path=smartpos/configuration.md).

## Mise à jour

1. Remplacez le dossier `smartpos` par la nouvelle version
2. Relancez `composer install --no-dev`
3. Reconnectez-vous à Dolibarr : les mises à jour de base de données sont appliquées automatiquement