Guide d'installation
Tout le processus, du début à la fin. Prévoyez environ 20 minutes, dont la plus grande partie à attendre des téléchargements.
Téléchargez et ouvrez Raspberry Pi Imager — l'outil officiel et gratuit de Raspberry Pi eux-mêmes. Insérez votre carte SD, puis dans Imager :
Choisir l'OS → Raspberry Pi OS (64 bits). Choisir le stockage → votre carte SD.
Avant de cliquer sur « Suivant », cliquez sur l'icône d'engrenage/paramètres (ou on vous le proposera) pour préconfigurer certaines choses — définissez un nom d'hôte, activez SSH et saisissez vos informations Wi-Fi ici. Le faire maintenant permet au Pi de se connecter automatiquement à votre réseau au premier démarrage, sans qu'un clavier ou une souris soit branché dessus.
Cliquez sur Écrire et attendez la fin (c'est la partie lente).
Insérez la carte SD dans le Pi, branchez-le à votre écran et allumez-le. Laissez-lui quelques minutes pour son premier démarrage — il effectue en arrière-plan une configuration unique.
Si vous êtes directement sur le Pi, ouvrez une fenêtre de terminal. Si vous vous connectez depuis un autre ordinateur, ouvrez votre propre terminal et connectez-vous d'abord en SSH (remplacez par le nom d'hôte défini à l'étape 1) :
Lancez ensuite l'installateur :
Cela télécharge la dernière version et configure tout automatiquement — Node.js, l'application elle-même et le mode kiosque de l'écran mural. Il demandera votre mot de passe en cours de route (pour quelques installations système uniques) et redémarrera automatiquement à la fin.
Après le redémarrage, l'affichage du calendrier devrait apparaître automatiquement sur l'écran connecté. Depuis votre téléphone ou n'importe quel navigateur du même réseau, ouvrez l'adresse affichée sur cet écran pour terminer la configuration — vous indiquerez s'il s'agit de votre appareil principal et (pour l'appareil principal) saisirez une adresse e-mail pour l'activer. Si vous utilisez Home Assistant, la configuration vous demandera aussi si vous souhaitez le connecter — facultatif, et tout aussi simple à faire plus tard dans les paramètres si vous préférez l'ignorer pour l'instant. Aucun paiement requis — l'adresse e-mail sert uniquement à recevoir les avis de mise à jour.
Ensuite : thèmes, sources de calendrier, et tous les membres de votre famille ou de votre équipe.
Un raccourci à connaître : Ctrl+Alt+K active ou désactive l'affichage kiosque, si vous avez un jour besoin d'accéder à un terminal sur le Pi lui-même.
Cela dépend de l'étape. Si ~/piazzahq n'existe pas encore, la commande d'installation en une ligne peut être relancée sans risque depuis le début. S'il existe déjà (même après une tentative partielle ou ratée), ne relancez pas la commande en une ligne — elle refuse volontairement, pour éviter de tout effacer. Lancez plutôt bash ~/piazzahq/install.sh directement ; cette partie peut être relancée sans risque autant de fois que nécessaire et ne répète pas les étapes déjà réussies. Si l'échec se produit toujours au même endroit, notez l'erreur exacte et contactez-nous.
Laissez-lui une minute de plus — l'affichage kiosque peut mettre un moment à démarrer après le démarrage. S'il reste noir, vérifiez que le câble HDMI est dans le port étiqueté HDMI0 sur un Pi 4/5, et non dans le second port.
Elle s'affiche directement sur l'écran mural lui-même une fois qu'il fonctionne. Si vous avez défini un nom d'hôte personnalisé à l'étape 1, essayez http://<ce-nom-d-hôte>.local depuis un téléphone connecté au même Wi-Fi.
Oui — tout appareil doté d'un navigateur web peut être un écran : une vieille tablette, le navigateur intégré d'une Fire Stick ou d'un Chromecast, un moniteur de rechange sur un petit boîtier de streaming. Dans l'application, allez dans Appareils → « Ajouter un affichage », choisissez la disposition à afficher, puis scannez le code QR sur le nouvel appareil ou saisissez l'adresse indiquée. Il apparaîtra dans votre liste d'écrans dès son premier chargement.
Si le nouvel appareil est sur le même Wi-Fi que votre Pi, cela fonctionne immédiatement. Pour un appareil qui change de réseau — une tablette que vous portez de pièce en pièce, par exemple — installez d'abord Tailscale sur le Pi et sur le nouvel appareil ; l'application le détecte automatiquement et vous donne un lien qui fonctionne de partout dans votre tailnet, et pas seulement sur le Wi-Fi actuel.
Home Assistant est un projet distinct et gratuit — il n'est pas fourni avec Piazza HQ, et la configuration ici se limite à la connexion à une installation qui fonctionne déjà chez vous. Si vous partez de zéro, l'option la plus simple et la plus clé en main est Home Assistant Green — une petite boîte livrée avec le système déjà installé ; il suffit de la brancher au secteur et au réseau.
Si vous préférez l'exécuter vous-même sur du matériel que vous avez déjà (un Pi de rechange, ou la même machine que votre serveur central Piazza HQ), voici la commande d'installation Docker officielle — elle fonctionne sur un Raspberry Pi ou n'importe quelle machine Linux où Docker Engine est déjà installé (remplacez d'abord par votre propre fuseau horaire et un dossier pour sa configuration) :
Une fois qu'il fonctionne, ouvrez http://<adresse de cette machine>:8123 pour terminer sa propre configuration — puis revenez ici (Paramètres → Home Assistant, ou l'assistant de configuration sur une installation neuve) pour le connecter.
Cette méthode Docker n'inclut pas les « applications » facultatives de Home Assistant (Zigbee2MQTT, un broker MQTT, etc.) — suffisant pour connecter des capteurs et des interrupteurs à Piazza HQ, mais si vous pensez en avoir besoin, flasher le système Home Assistant OS complet vous les procure aussi. Le processus d'installation de Home Assistant peut évoluer avec le temps — sa documentation officielle d'installation fait foi si quelque chose ici semble obsolète.
La configuration vous le propose au premier démarrage — collez simplement l'URL de votre Home Assistant (p. ex. http://homeassistant.local:8123) et un jeton d'accès de longue durée (dans Home Assistant : votre profil → onglet Sécurité → Jetons d'accès de longue durée → Créer un jeton). Ignoré, ou vous configurez un deuxième affichage ? Faites-le à tout moment dans Paramètres → Home Assistant. Dans les deux cas, l'URL et le jeton restent sur votre propre serveur — ils ne sont jamais envoyés à l'affichage ni au téléphone de quiconque. Une fois connecté, ajoutez un widget État de l'entité depuis la disposition pour afficher l'état actuel d'un capteur ou appareil, allumer ou éteindre des lumières et des interrupteurs, régler un thermostat ou lancer une scène.
Vous voulez aussi l'autre sens — Home Assistant qui allume/éteint un écran ou change la disposition d'un affichage ? C'est une configuration distincte, Paramètres → Contrôle par Home Assistant : voir le guide complet pour les trois façons de le connecter.
Télécharger PiazzaHQ-Setup.exe et lancez-le. Aucun droit d'administrateur nécessaire — il s'installe dans votre propre dossier utilisateur (%LocalAppData%\PiazzaHQ), et non dans Program Files, donc aucune invite UAC.
Node.js est inclus — rien d'autre à installer séparément.
Une case à cocher sur la page « Sélection des tâches supplémentaires » de l'assistant :
Non cochée (par défaut) — appareil de contrôle. Un raccourci classique sur le Bureau ouvre l'application en fenêtre, dans votre navigateur habituel. Idéal pour le PC que vous utilisez vraiment au quotidien.
Cochée — écran mural. Chaque raccourci ouvre le calendrier en plein écran sans barre de navigateur, et il est ajouté au démarrage pour s'ouvrir automatiquement à votre prochaine connexion. À utiliser sur un PC dédié à l'affichage.
Cochez « Lancer maintenant » à la fin de l'installation, ou double-cliquez simplement sur le nouveau raccourci du Bureau. Au premier lancement, le pare-feu Windows demandera d'autoriser l'application sur votre réseau — acceptez ; c'est normal pour tout ce qui ouvre un port en écoute, sans rapport avec la signature.
Mode écran mural : laissez-lui quelques secondes, puis il remplit l'écran. Pour quitter le plein écran, touchez/cliquez une fois n'importe où dessus — un petit bouton ⤢ Quitter le plein écran apparaît dans le coin pendant quelques secondes (Alt+F4 fonctionne toujours aussi).
Comme partout ailleurs à partir d'ici : depuis votre téléphone ou n'importe quel navigateur du même réseau, ouvrez l'adresse affichée sur l'écran pour terminer la configuration — indiquez s'il s'agit de votre appareil principal et saisissez une adresse e-mail pour l'activer. Thèmes, sources de calendrier, tous les membres de votre famille ou de votre équipe, tout est identique au Pi.
Les mises à jour arrivent de la même façon — l'application se vérifie et se met à jour automatiquement. Vous n'avez à relancer l'installateur que pour un changement qui concerne l'installateur lui-même (rare — nous le dirons toujours explicitement si une version l'exige).
Cliquez sur Informations complémentaires sur l'écran d'avertissement bleu, puis sur Exécuter quand même. Cette version est volontairement non signée pour l'instant — l'avertissement est attendu et ne signifie pas qu'il y a un problème avec le fichier.
Touchez ou cliquez n'importe où sur l'écran — un petit bouton ⤢ Quitter le plein écran apparaît dans le coin. Alt+F4 fonctionne toujours aussi. (Le bouton qui apparaît au toucher nécessite un installateur de la version actuelle de ce guide ; une installation beaucoup plus ancienne n'a peut-être que Alt+F4 jusqu'à sa réinstallation.)
Oui — comme avec le Pi : tout appareil doté d'un navigateur peut être un écran. Dans l'application, allez dans Appareils → « Ajouter un affichage », choisissez une disposition, puis scannez le code QR ou saisissez l'adresse indiquée depuis le nouvel appareil.
Vous exécutez déjà d'autres applications auto-hébergées (Plex, Home Assistant, la boutique d'applications d'un NAS) sur cette machine ? Vous l'avez presque certainement. Sinon, l'installation officielle tient en une ligne sous Linux :
Sous Mac ou Windows, installez plutôt Docker Desktop .
Créez un dossier pour cela, et dedans, un fichier nommé docker-compose.yml avec ce contenu :
Remplacez par votre propre fuseau horaire. C'est toute la configuration — vos données vivent dans le volume nommé, bien séparées du conteneur lui-même.
Voilà — pas de script d'installation séparé, pas de paquets système à gérer en dehors de Docker lui-même.
Ouvrez http://<adresse de cette machine>:3000/app depuis votre téléphone ou n'importe quel navigateur du même réseau pour terminer la configuration — indiquez s'il s'agit de votre appareil principal et saisissez une adresse e-mail pour l'activer. Tout le reste (thèmes, sources de calendrier, tous les membres de votre famille ou de votre équipe) fonctionne exactement comme avec le Pi — vous le gérez simplement entièrement depuis un navigateur au lieu d'un écran physique.
Les mises à jour fonctionnent volontairement différemment ici : le programme de mise à jour de l'application est désactivé dans un conteneur (il n'a nulle part où écrire). À la place :
Le réseau en pont (par défaut dans le fichier compose ci-dessus) convient pour les flux de calendrier, la météo et les mises à jour, mais ne peut pas découvrir les appareils du réseau local ni résoudre les noms d'hôte .local. Supprimez le bloc ports: et ajoutez network_mode: host à la place — l'application s'exécute alors directement sur le réseau propre de l'hôte.
Dans le volume Docker nommé piazzahq-data, et non dans le conteneur lui-même — récupérer une nouvelle image et recréer le conteneur n'y touche jamais. Trouvez son véritable chemin sur le disque avec docker volume inspect piazzahq-data si vous voulez le sauvegarder directement, ou utilisez Paramètres → Sauvegardes → « Télécharger la sauvegarde complète » depuis l'application.
Oui — comme partout ailleurs : tout appareil doté d'un navigateur peut être un écran. Dans l'application, allez dans Appareils → « Ajouter un affichage », choisissez une disposition, puis scannez le code QR ou saisissez l'adresse indiquée depuis le nouvel appareil.
Oui — Proxmox lui-même n'est pas un hôte Docker ; il s'exécute donc dans une VM ou un conteneur LXC sur votre serveur Proxmox, mais dans les deux cas la configuration est exactement la même à partir de là. Le plus simple : une petite VM Debian ou Ubuntu (1 vCPU, ~1 Go de RAM suffisent largement) avec Docker installé normalement, puis suivez ce guide tel quel. Vous préférez un conteneur LXC ? Activez Nesting et Keyctl dans Options → Fonctionnalités de ce conteneur d'abord — Docker en a besoin pour créer ses propres espaces de noms imbriqués — puis installez Docker à l'intérieur de la même manière.
Configurer l'accès à distance, passer manuellement à X11, consulter les journaux — voir la page de dépannage pour des commandes à copier-coller (spécifiques au Pi pour l'instant).
Prêt à explorer ce qu'il y a vraiment dans l'application ? Le guide d'utilisation couvre chaque onglet.