Aller au contenu

Prérequis

Avant d’installer KiwiDesk, vérifiez que vous disposez d’une machine capable de faire tourner Docker, d’un accès administrateur à cette machine et, si l’équipe ou les clients doivent l’atteindre depuis l’extérieur, d’un nom de domaine.

KiwiDesk tourne sur n’importe quelle machine Linux capable d’exécuter Docker : un serveur loué (VPS), un mini-PC dans l’arrière-boutique ou un NAS compatible Docker. Les images sont publiées pour les processeurs amd64 (Intel, AMD) et arm64 (Raspberry Pi 5, serveurs Ampere, Mac Apple Silicon).

Ressource Minimum Conseillé pour plusieurs boutiques
Processeur 2 cœurs 4 cœurs
Mémoire 2 Go 4 Go ou plus
Disque 20 Go SSD 50 Go SSD ou plus
Docker Engine version récente avec le plugin Docker Compose v2

L’espace disque sert surtout aux photos des appareils, aux pièces jointes des messages, aux médias des écrans de la boutique et aux archives du journal d’audit, rangés dans le volume uploads. La page Paramètres > Système montre la taille de la base, celle des fichiers et l’espace libre (voir Surveillance et santé).

  • Docker Engine et Docker Compose v2 (la commande docker compose, sans tiret) ;
  • ou Portainer, si vous gérez vos conteneurs depuis une interface web ;
  • un accès au registre ghcr.io, où sont publiées les images de KiwiDesk. Tant que le dépôt est privé, il faut un jeton GitHub avec le droit read:packages (voir Installer KiwiDesk).

Vous n’avez pas besoin d’installer PostgreSQL ni Node.js : ils sont fournis par les conteneurs.

KiwiDesk est une application web : les postes de la boutique y accèdent avec un navigateur.

  • Usage uniquement dans la boutique : une adresse fixe sur le réseau local suffit (http://192.168.1.10:3000), sans HTTPS. Certaines fonctions du navigateur (caméra pour photographier un appareil, presse-papiers) exigent toutefois HTTPS hors de localhost.
  • Accès depuis l’extérieur (plusieurs boutiques, page de suivi des clients, SMS reçus quand le téléphone est en 4G, connexion Google ou Microsoft) : il faut un nom de domaine, par exemple kiwidesk.ma-boutique.fr, et un reverse proxy qui fournit le certificat HTTPS. Voir Reverse proxy et HTTPS.

Le serveur doit pouvoir sortir vers Internet en HTTPS pour les services que vous activez : relais SMS api.sms-gate.app, serveurs SMTP et IMAP, Google et Microsoft, fournisseurs d’IA.

Le matériel de caisse (imprimante de tickets, tiroir-caisse, terminal de paiement) est piloté par le KiwiDesk Bridge, un petit programme installé sur le poste du comptoir ou sur un mini-PC Linux à côté. Il fonctionne sous Windows, Linux et macOS. Voir Présentation du Bridge.

Le navigateur conseillé pour les postes est un navigateur récent basé sur Chromium (Chrome, Edge) ou Firefox.