Installer le Bridge
Le Bridge s’installe une fois sur le poste du comptoir et démarre ensuite tout seul avec lui. Il existe en exécutable autonome (rien d’autre à installer) pour Windows, Linux et macOS, et en image Docker pour un mini-PC Linux.
Récupérer le Bridge
Section intitulée « Récupérer le Bridge »Le bouton Télécharger KiwiDesk Bridge (GitHub) de Paramètres > Caisses & matériel (ou de
Paramètres > À propos / Système) mène aux versions publiées. Chaque version bridge-v*
propose :
| Fichier | Système |
|---|---|
kiwidesk-bridge-<version>-win32-x64.exe |
Windows 10 et 11 (64 bits) |
kiwidesk-bridge-<version>-linux-x64 |
Linux, processeur Intel / AMD |
kiwidesk-bridge-<version>-linux-arm64 |
Linux ARM (Raspberry Pi…) |
kiwidesk-bridge-<version>-darwin-arm64 |
Mac Apple Silicon |
kiwidesk-bridge-<version>-darwin-x64 |
Mac Intel |
Téléchargez aussi le fichier .sha256 correspondant et le script d’installation de votre
système, et vérifiez l’empreinte avant de lancer quoi que ce soit.
Installer comme service
Section intitulée « Installer comme service »-
Placez l’exécutable et
install-windows.ps1dans un même dossier. -
Vérifiez l’empreinte :
Get-FileHash .\kiwidesk-bridge-0.4.3-win32-x64.exe -Algorithm SHA256doit donner la valeur du fichier.sha256. -
Ouvrez PowerShell dans ce dossier et lancez :
Fenêtre de terminal powershell -ExecutionPolicy Bypass -File .\install-windows.ps1 .\kiwidesk-bridge-0.4.3-win32-x64.exe -
Le Bridge est installé comme tâche planifiée lancée à l’ouverture de session, sans fenêtre. Ouvrez
http://127.0.0.1:4242dans le navigateur du poste.
Désinstallation : même commande avec -Uninstall. La configuration est conservée dans
%APPDATA%\KiwiDesk Bridge.
-
Vérifiez l’empreinte :
sha256sum -c kiwidesk-bridge-0.4.3-linux-x64.sha256. -
Lancez le script avec
sudo, depuis le compte qui utilise la caisse :Fenêtre de terminal chmod +x install-linux.shsudo ./install-linux.sh ./kiwidesk-bridge-0.4.3-linux-x64 -
Le Bridge est installé dans
/opt/kiwidesk-bridgecomme service systemdkiwidesk-bridge. Le compte qui le fait tourner est ajouté aux groupeslp(imprimantes USB) etdialout(ports série et TPE USB) : aucun accès root n’est nécessaire ensuite. -
Contrôlez :
systemctl status kiwidesk-bridge, puis ouvrezhttp://127.0.0.1:4242.
Option --user <compte> pour choisir un autre compte ; --uninstall pour désinstaller. Les
données restent dans ~/.kiwidesk-bridge.
-
Vérifiez l’empreinte :
shasum -a 256 kiwidesk-bridge-0.4.3-darwin-arm64. -
Lancez, depuis votre session (sans
sudo) :Fenêtre de terminal chmod +x install-macos.sh./install-macos.sh ./kiwidesk-bridge-0.4.3-darwin-arm64 -
Le Bridge est installé comme LaunchAgent
com.kiwidesk.bridge, lancé à l’ouverture de session. Ouvrezhttp://127.0.0.1:4242.
Désinstallation : ./install-macos.sh --uninstall. Les données restent dans
~/Library/Application Support/KiwiDesk Bridge.
Pour un mini-PC ou un serveur Linux près du comptoir. L’image
ghcr.io/kaipicpic/kiwidesk-bridge existe pour amd64 et arm64.
-
Connectez la machine au registre une fois (
docker login ghcr.io, jeton avec le droitread:packages), comme pour le serveur. -
Récupérez
apps/bridge/docker-compose.bridge.ymldu dépôt, ou collez-le dans une stack Portainer. -
Générez un code d’appairage dans KiwiDesk (voir Associer le Bridge), puis démarrez :
Fenêtre de terminal KIWIDESK_SERVER_URL=https://kiwidesk.ma-boutique.fr KIWIDESK_PAIRING_CODE=123456 \docker compose -f docker-compose.bridge.yml up -d -
Pour un périphérique USB ou série, décommentez sa ligne dans
devices:(par exemple/dev/ttyACM0:/dev/ttyACM0) et la sectiongroup_add:, puis redéployez.
Points à connaître :
- le conteneur utilise le réseau de l’hôte (
network_mode: host) pour voir les imprimantes et TPE de la boutique ; sa page locale est donc surhttp://127.0.0.1:4242de la machine ; - le volume
bridge-datagarde la configuration et le jeton : le code d’appairage n’est utilisé qu’une fois et peut rester dans les variables ; - un périphérique listé dans
devices:mais absent de la machine empêche le conteneur de démarrer ; KIWIDESK_BRIDGE_VERSIONfige une version de l’image (par défautlatest).
Variables d’environnement du Bridge
Section intitulée « Variables d’environnement du Bridge »Utiles surtout avec Docker ; l’exécutable se règle aussi depuis sa page locale.
| Variable | Rôle |
|---|---|
KIWIDESK_SERVER_URL |
Adresse de KiwiDesk, préremplie sur la page du Bridge (obligatoire avec Docker). |
KIWIDESK_PAIRING_CODE |
Code à 6 chiffres utilisé au premier démarrage, ignoré ensuite. |
KIWIDESK_BRIDGE_ACCESS_CODE |
Ouvre la page locale aux autres postes avec ce code (6 caractères au moins). |
KIWIDESK_BRIDGE_ALLOWED_NETWORKS |
Réseaux autorisés à ouvrir la page, par exemple 192.168.1.0/24. Vide : les réseaux privés. |
KIWIDESK_BRIDGE_REMOTE_ACCESS |
off referme la page au réseau, même si un code d’accès est défini. |
KIWIDESK_BRIDGE_HOME |
Dossier des données (par défaut ~/.kiwidesk-bridge ou %APPDATA%\KiwiDesk Bridge). |
KIWIDESK_BRIDGE_DEBUG |
1 écrit aussi les messages de débogage dans le journal. |
Les données du Bridge
Section intitulée « Les données du Bridge »Le dossier de données contient config.json (adresse de KiwiDesk, jeton du Bridge,
périphériques déclarés ; lisible par son seul propriétaire), bridge.log (journal, tourné à
1 Mo), local-audit.log (modifications faites depuis la page locale) et
payment-results.json (résultats de paiement en attente d’envoi). Ne le supprimez pas : il
faudrait associer le poste et déclarer ses périphériques de nouveau.
Mettre à jour le Bridge
Section intitulée « Mettre à jour le Bridge »Installez la nouvelle version avec le même script (ou docker compose pull puis up -d) : la
configuration est conservée. Un paiement en cours au moment de l’arrêt est remonté à KiwiDesk au
redémarrage comme résultat inconnu, à vérifier sur le TPE.