Guía de configuración
Todo el proceso, de principio a fin. Calcula unos 20 minutos, la mayor parte esperando descargas.
Descarga y abre Raspberry Pi Imager la herramienta oficial y gratuita del propio Raspberry Pi. Inserta la tarjeta SD y, en Imager:
Elegir SO → Raspberry Pi OS (64 bits). Elegir almacenamiento → tu tarjeta SD.
Antes de pulsar «Siguiente», haz clic en el icono de engranaje/ajustes (o te lo propondrá) para preconfigurar cosas: define un nombre de host, activa SSH e introduce aquí los datos de tu wifi. Hacerlo ahora permite que la Pi se conecte a tu red automáticamente en el primer arranque, sin necesidad de conectarle teclado ni ratón.
Haz clic en Escribir y espera a que termine (esta es la parte lenta).
Pasa la tarjeta SD a la Pi, conéctala a tu pantalla y enciéndela. Dale un par de minutos para el primer arranque: está haciendo una configuración puntual en segundo plano.
Si estás directamente en la Pi, abre una ventana de Terminal. Si te conectas desde otro ordenador, abre tu propio terminal y conéctate primero por SSH (sustituye por el nombre de host que definiste en el paso 1):
Luego ejecuta el instalador:
Esto descarga la última versión y lo configura todo automáticamente: Node.js, la propia aplicación y el modo quiosco de la pantalla de pared. Te pedirá la contraseña a mitad de camino (para un par de instalaciones del sistema puntuales) y se reiniciará solo al terminar.
Tras reiniciarse, la pantalla del calendario debería aparecer automáticamente en la pantalla conectada. Desde tu teléfono o cualquier navegador de la misma red, visita la dirección que se muestra en esa pantalla para terminar la configuración: elegirás si este es tu dispositivo principal y (en el principal) introducirás un correo electrónico para activarlo. Si usas Home Assistant, la configuración también te preguntará si quieres conectarlo: es opcional, y igual de fácil de hacer más tarde en Ajustes si prefieres omitirlo por ahora. No hace falta pagar: el correo electrónico solo sirve para recibir avisos de actualización.
A partir de ahí: temas, fuentes de calendario y todos los miembros de tu familia o equipo.
Un atajo que conviene conocer: Ctrl+Alt+K activa o desactiva la pantalla en modo quiosco, por si alguna vez necesitas acceder a un terminal en la propia Pi.
Depende de la parte. Si ~/piazzahq aún no existe, el comando de instalación de una línea se puede volver a ejecutar sin riesgo desde cero. Si ya existe (incluso por un intento parcial o fallido), no vuelvas a ejecutar la línea única: se negará a propósito, para no borrar nada. En su lugar ejecuta bash ~/piazzahq/install.sh directamente; esa parte se puede volver a ejecutar sin riesgo tantas veces como haga falta y no repite los pasos que ya funcionaron. Si siempre falla en el mismo punto, anota el error exacto y ponte en contacto con nosotros.
Dale un minuto más: la pantalla en modo quiosco puede tardar un momento en arrancar después del encendido. Si sigue en blanco, comprueba que el cable HDMI esté en el puerto etiquetado HDMI0 en una Pi 4/5, no en el segundo puerto.
Se muestra directamente en la propia pantalla de pared una vez que está en marcha. Si definiste un nombre de host personalizado en el paso 1, prueba http://<ese-nombre-de-host>.local desde un teléfono conectado al mismo wifi.
Sí: cualquier dispositivo con navegador web puede ser una pantalla: una tablet vieja, el navegador integrado de un Fire Stick o Chromecast, un monitor de sobra conectado a un reproductor de streaming barato. En la aplicación, ve a Dispositivos → «Añadir una pantalla», elige qué diseño debe mostrar y escanea el código QR en el nuevo dispositivo o escribe la dirección indicada. Aparecerá en tu lista de pantallas la primera vez que cargue.
Si el nuevo dispositivo está en el mismo wifi que tu Pi, funciona al instante. Para algo que cambia de red (una tablet que llevas de una habitación a otra, por ejemplo), instala primero Tailscale en la Pi y en el nuevo dispositivo; la aplicación lo detecta automáticamente y te da un enlace que funciona desde cualquier lugar de tu tailnet y no solo desde el wifi actual.
Home Assistant es un proyecto aparte y gratuito: no viene con Piazza HQ, y la configuración aquí solo se ocupa de conectarse a uno que ya tengas en marcha. Si empiezas de cero, la opción más cómoda y sin complicaciones es Home Assistant Green una cajita que llega con todo ya instalado: solo hay que conectarla a la corriente y a la red.
Si prefieres ejecutarlo tú mismo en hardware que ya tienes (una Pi de sobra o la misma máquina que tu servidor central de Piazza HQ), este es el comando oficial de instalación con Docker: funciona en una Raspberry Pi o en cualquier equipo Linux con Docker Engine ya instalado (sustituye antes por tu propia zona horaria y una carpeta para su configuración):
Cuando esté en marcha, visita http://<dirección de esa máquina>:8123 para terminar su propia configuración y luego vuelve aquí (Ajustes → Home Assistant, o el asistente de configuración en una instalación nueva) para conectarlo.
Esta vía con Docker no incluye las «apps» opcionales de Home Assistant (Zigbee2MQTT, un broker MQTT, etc.): vale para conectar sensores e interruptores a Piazza HQ, pero si crees que las vas a querer, grabar el Home Assistant OS completo también te las da. El proceso de instalación de Home Assistant puede cambiar con el tiempo; su documentación oficial de instalación es la referencia si algo de aquí parece desactualizado.
La configuración te lo pregunta en el primer arranque: solo tienes que pegar la URL de tu Home Assistant (p. ej., http://homeassistant.local:8123) y un token de acceso de larga duración (en Home Assistant: tu perfil → pestaña Seguridad → Tokens de acceso de larga duración → Crear token). ¿Lo omitiste o estás configurando una segunda pantalla? Hazlo cuando quieras en Ajustes → Home Assistant. En ambos casos, la URL y el token se quedan en tu propio servidor: nunca se envían a la pantalla ni al teléfono de nadie. Una vez conectado, añade un widget de Estado de la entidad desde el diseño para mostrar el estado actual de cualquier sensor o dispositivo, encender y apagar luces e interruptores, ajustar un termostato o ejecutar una escena.
¿Quieres que funcione también en sentido contrario: que Home Assistant encienda o apague una pantalla o cambie el diseño de una pantalla? Es una configuración aparte, Ajustes → Control desde Home Assistant: consulta la guía completa con las tres formas de conectarlo.
Descargar PiazzaHQ-Setup.exe y ejecútalo. No hacen falta permisos de administrador: se instala en tu propia carpeta de usuario (%LocalAppData%\PiazzaHQ), no en Archivos de programa, así que no aparece ningún aviso de UAC.
Node.js viene incluido: no hay que instalar nada más por separado.
Una casilla en la página «Seleccione las tareas adicionales» del asistente:
Sin marcar (predeterminado): dispositivo de control. Un acceso directo normal en el Escritorio abre la aplicación en una ventana, en tu navegador habitual. Bueno para el PC que usarás de verdad a diario.
Marcada: pantalla de pared. Cada acceso directo abre el calendario a pantalla completa sin barra del navegador y se añade al Inicio para que arranque solo la próxima vez que inicies sesión. Úsalo en un PC dedicado a ser la pantalla.
Marca «Ejecutar ahora» al final de la instalación o haz doble clic en el nuevo acceso directo del Escritorio. La primera vez, el Firewall de Windows te preguntará si permites la aplicación en tu red: di que sí; es normal en cualquier cosa que abre un puerto en escucha y no tiene que ver con la firma.
Modo pantalla de pared: dale unos segundos y llenará la pantalla. Para salir de la pantalla completa, toca o haz clic una vez en cualquier parte: durante unos segundos aparecerá en la esquina un pequeño botón ⤢ Salir de pantalla completa (Alt+F4 también funciona siempre).
Igual que en todo lo demás a partir de aquí: desde tu teléfono o cualquier navegador de la misma red, visita la dirección que se muestra en la pantalla para terminar la configuración: elige si este es tu dispositivo principal e introduce un correo electrónico para activarlo. Temas, fuentes de calendario, todos los miembros de tu familia o equipo: todo igual que en la Pi.
Las actualizaciones llegan de la misma manera: la aplicación comprueba y se actualiza sola. Solo tendrás que volver a ejecutar el instalador si algo afecta al propio instalador (raro; siempre lo diremos explícitamente si una versión lo necesita).
Haz clic en Más información en la pantalla de advertencia azul y luego en Ejecutar de todas formas. Esta versión no está firmada a propósito por ahora: la advertencia es esperable y no indica que haya nada realmente mal en el archivo.
Toca o haz clic en cualquier parte de la pantalla: aparece un pequeño botón ⤢ Salir de pantalla completa en la esquina. Alt+F4 también funciona siempre. (El botón que aparece al tocar necesita un instalador de la versión actual de esta guía; una instalación mucho más antigua puede tener solo Alt+F4 hasta que se reinstale.)
Sí, igual que con la Pi: cualquier dispositivo con navegador puede ser una pantalla. En la aplicación, ve a Dispositivos → «Añadir una pantalla», elige un diseño y escanea el código QR o escribe desde el nuevo dispositivo la dirección indicada.
¿Ya ejecutas otras aplicaciones autoalojadas (Plex, Home Assistant, la tienda de aplicaciones de un NAS) en esta máquina? Casi seguro que lo tienes. Si no, la instalación oficial es una línea en Linux:
En Mac o Windows, instala en su lugar Docker Desktop .
Crea una carpeta para ello y, dentro, un archivo llamado docker-compose.yml con esto:
Sustituye por tu propia zona horaria. Esa es toda la configuración: tus datos viven en el volumen con nombre, bien separados del propio contenedor.
Eso es todo: sin script de instalación aparte y sin paquetes del sistema que gestionar aparte de Docker.
Visita http://<dirección de esa máquina>:3000/app desde tu teléfono o cualquier navegador de la misma red para terminar la configuración: elige si este es tu dispositivo principal e introduce un correo electrónico para activarlo. Todo lo demás (temas, fuentes de calendario, todos los miembros de tu familia o equipo) funciona exactamente igual que con la Pi; solo que lo gestionas por completo desde un navegador en lugar de una pantalla física.
Aquí las actualizaciones funcionan de otra manera a propósito: el actualizador de la aplicación está desactivado dentro de un contenedor (no tiene dónde escribir). En su lugar:
La red en puente (la predeterminada en el archivo compose de arriba) sirve para los feeds de calendario, el tiempo y las actualizaciones, pero no puede descubrir dispositivos de la red local ni resolver nombres de host .local. Quita el bloque ports: y añade network_mode: host en su lugar: la aplicación se ejecuta entonces directamente en la propia red del anfitrión.
En el volumen de Docker con nombre piazzahq-data, no dentro del contenedor: descargar una imagen nueva y recrear el contenedor nunca lo toca. Encuentra su ruta real en el disco con docker volume inspect piazzahq-data si quieres copiarlo directamente, o usa Ajustes → Copias de seguridad → «Descargar copia de seguridad completa» desde la aplicación.
Sí, igual que en todo lo demás: cualquier dispositivo con navegador puede ser una pantalla. En la aplicación, ve a Dispositivos → «Añadir una pantalla», elige un diseño y escanea el código QR o escribe desde el nuevo dispositivo la dirección indicada.
Sí: Proxmox en sí no es un host de Docker, así que se ejecuta dentro de una VM o un contenedor LXC en tu servidor Proxmox, pero en ambos casos la configuración a partir de ahí es exactamente la misma. Lo más sencillo: una pequeña VM con Debian o Ubuntu (1 vCPU, ~1 GB de RAM sobran) con Docker instalado de la forma habitual y luego seguir esta guía tal cual. ¿Prefieres un contenedor LXC? Activa Nesting y Keyctl en Opciones → Funciones de ese contenedor primero (Docker las necesita para crear sus propios espacios de nombres anidados) y luego instala Docker dentro de la misma manera.
Configurar el acceso remoto, cambiar manualmente a X11, revisar registros: consulta la página de solución de problemas con comandos para copiar y pegar (por ahora específicos de la Pi).
¿Listo para explorar lo que hay realmente en la aplicación? La guía de usuario cubre cada pestaña.