Aller au contenu

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.

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.

  1. Placez l’exécutable et install-windows.ps1 dans un même dossier.

  2. Vérifiez l’empreinte : Get-FileHash .\kiwidesk-bridge-0.4.3-win32-x64.exe -Algorithm SHA256 doit donner la valeur du fichier .sha256.

  3. 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
  4. Le Bridge est installé comme tâche planifiée lancée à l’ouverture de session, sans fenêtre. Ouvrez http://127.0.0.1:4242 dans le navigateur du poste.

Désinstallation : même commande avec -Uninstall. La configuration est conservée dans %APPDATA%\KiwiDesk 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.

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.

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.