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.
Le serveur
Section intitulée « Le serveur »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é).
Les logiciels
Section intitulée « Les logiciels »- 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 droitread:packages(voir Installer KiwiDesk).
Vous n’avez pas besoin d’installer PostgreSQL ni Node.js : ils sont fournis par les conteneurs.
Le réseau et le nom de domaine
Section intitulée « Le réseau et le nom de domaine »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 delocalhost. - 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 poste du comptoir
Section intitulée « Le poste du comptoir »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.