Installer un PC de salle en une commande

Une nouvelle salle se met en service en trois gestes : le propriétaire crée la salle en ligne et reçoit un code de rattachement, le technicien tape une seule commande sur le PC de la salle, puis le propriétaire confirme que c’est bien sa salle. C’est le seul moment où le technicien utilise un terminal ; tout le reste se fait au back-office.

1. Le propriétaire crée la salle et vous envoie le code

📍 Où dans le BO en ligneCompagnie→Salles→Ajouter une salleQui peut :PropriétaireAdministrateur de la compagnie

Le propriétaire saisit le nom, le fuseau et la devise de la salle. L’écran affiche alors, une seule fois :

• le code de rattachement (8 caractères, par exemple XXXX-XXXX), valable une seule fois et jusqu’à l’échéance affichée ;
• sous le titre PC neuf : la commande du technicien, la commande complète, prête à copier, avec les boutons Copier la commande et de partage.

Il vous l’envoie (message, WhatsApp). Si le code est perdu ou envoyé à la mauvaise personne, il clique Nouveau code (retire celui-ci) : l’ancien ne marche plus.

« Aucune version de la salle n'est encore publiée par l'éditeur »

Si l’écran affiche cette phrase à la place de la commande, l’installation en une commande n’est pas encore possible sur cette plateforme : prévenez l’éditeur. La commande n’est jamais montrée quand elle ne peut pas marcher.

2. Vous tapez la commande sur le PC de la salle

Préparez le PC (voir Le PC de salle) : Ubuntu 22.04 ou 24.04, branché sur le réseau de la salle, avec Internet. Ouvrez un terminal et collez la commande reçue. Elle a cette forme :

📍 À taper sur : PC de la salle (Ubuntu)

wget -nv -O- https://<adresse de votre plateforme>/installer | sudo bash -s -- --code <CODE>

Si le PC n’a pas wget, la même chose avec curl :

📍 À taper sur : PC de la salle (Ubuntu)

curl -fsSL https://<adresse de votre plateforme>/installer | sudo bash -s -- --code <CODE>

Le mot de passe demandé est celui de votre compte Ubuntu (pour sudo). Ensuite, la commande déroule seule ses étapes et les affiche :

1. Contrôles du PC, avant de rien toucher : le système (Ubuntu 22.04 ou 24.04), le processeur (64 bits), au moins 10 Go libres, l’accès Internet à la plateforme, l’heure du PC, et qu’aucun autre programme n’occupe ce dont la salle a besoin. Un problème s’affiche en rouge (🔴) avec la commande qui le corrige, et rien n’est installé.
2. La version du serveur : la version courante est téléchargée depuis la plateforme. Le PC n’installe qu’une version signée par l’éditeur : une archive modifiée est refusée.
3. Paquets du système et, si besoin, Docker.
4. Installation et démarrage. Le premier démarrage peut prendre plusieurs minutes (base neuve).
5. Rattachement à la plateforme avec votre code.

À la fin, la commande affiche « ✔ Serveur de salle Lucky Touch … installé », l’adresse du back-office de la salle, l’identifiant de l’administrateur initial et la commande qui affiche son mot de passe. Ce mot de passe n’est jamais affiché à l’écran pendant l’installation : il est rangé sur le PC, lisible par l’administrateur du PC seulement. Changez-le à la première connexion au back-office.

Une coupure ? Relancez la même commande

Une installation interrompue (courant, réseau, programme à arrêter) se reprend en relançant exactement la même commande : rien n’est refait deux fois, ni la base ni les réglages ne sont recréés. Le code n’est consommé qu’au rattachement : si entre-temps il a expiré, demandez un nouveau code au propriétaire et relancez avec ce nouveau code.

Si le rattachement échoue

La salle est alors installée et tourne ; seul le rattachement manque. La commande le dit et propose deux chemins :

• un nouveau code demandé au propriétaire, puis la même commande relancée avec ce code ;
• ou, sans terminal : au back-office de la salle, Paramètres → Plateforme, saisir le code dans Code de rattachement, puis Rattacher (voir Rattacher la salle à la plateforme). Relancez ensuite la commande pour terminer l’installation.

Si Lucky Touch est déjà installé sur ce PC

La commande refuse de réinstaller par-dessus une salle qui tourne, et dit quoi faire : les mises à jour passent par le bouton du back-office (Mettre à jour une salle) ; une réinstallation se fait sur un PC neuf, avec la sauvegarde (Restaurer la salle sur un PC neuf).

3. Le propriétaire confirme « C’est bien ma salle »

📍 Où dans le BO en ligneCompagnie→SallesQui peut :PropriétaireAdministrateur de la compagnie

Dès le rattachement, la salle apparaît en tête de la liste avec « Une salle vient de se rattacher : est-ce bien la vôtre ? » et ce qu’elle a déclaré : Nom du PC déclaré, Première connexion, Depuis l’adresse, Devise, Version. Le propriétaire compare ces informations avec vous (le nom du PC, l’heure de l’installation), puis clique C’est bien ma salle.

Tant que ce n’est pas fait, la salle envoie déjà ses données mais ne reçoit rien de la compagnie (ni personnes, ni PIN). Si ce n’est pas la sienne, Ce n’est pas ma salle… coupe ce serveur et donne un nouveau code.

Vérifier le script avant de le lancer (facultatif)

La commande télécharge un script public, servi par votre plateforme, qui ne contient aucun secret. Si vous voulez vous assurer qu’il n’a pas été modifié, demandez son empreinte à l’éditeur, puis calculez-la sur le PC avec wget -qO- https://<adresse de votre plateforme>/installer | sha256sum et comparez les deux.

Et ensuite

• Le PC de salle : ce qu’il faut savoir pour qu’il tourne longtemps.
• Sauvegarder et restaurer : poser la phrase de restauration et adopter une clé USB, le jour même.
• Installer une caisse et Boîtiers : brancher, flasher, vérifier.