Solución de problemas
Todo lo de aquí se ejecuta en la propia Pi: directamente o por SSH desde otro ordenador (ssh [email protected], o el nombre de host que hayas definido) o desde un teléfono con una aplicación SSH como Termius o PiSSH. Toca el icono de cualquier comando para copiarlo.
Accede a la aplicación de control desde cualquier lugar, no solo desde tu red doméstica: configura Tailscale, una red privada (no se expone nada públicamente). Es interactivo: te mostrará un enlace de inicio de sesión para abrirlo una vez en cualquier navegador.
¿Ya está configurado? Comprueba su estado:
El instalador lo ofrece automáticamente hacia el final de la configuración. Si lo omitiste o quieres hacerlo manualmente:
sudo raspi-config → 6 Opciones avanzadas → Wayland → W1 X11 → reiniciar.Se puede volver a ejecutar tantas veces como haga falta: no repite los pasos que ya funcionaron y nunca toca tus datos reales (eventos, fotos, tareas).
curl | bash una vez que ~/piazzahq ya existe: se niega a propósito, precisamente para que no pueda usarse para borrar por accidente una instalación real. El comando de arriba es el que realmente se puede repetir sin riesgo.Destructivo. Este es un paso distinto y mucho mayor que el comando de reparación de arriba: úsalo solo si de verdad quieres perderlo todo y empezar como si fuera una Pi nueva. La gran mayoría de las situaciones de «algo va mal» se resuelven con el comando de reparación de arriba, no con este.
Destructivo. A diferencia del comando de reinstalación desde cero de arriba, este no reinstala nada después. Úsalo cuando de verdad quieras que Piazza HQ desaparezca de este dispositivo concreto (retirarlo, reutilizar la Pi para otra cosa), no cuando estés resolviendo problemas.
Tras el encendido, la pantalla pasa por varias fases antes de que aparezca el diseño, y en una Pi pequeña eso lleva tiempo: en una Pi 3B+, espera que la pantalla se quede blanca y luego oscura durante cerca de un minuto antes de que se dibuje el diseño. Es la Pi ocupada arrancando, no una avería. Si la tuya sigue en blanco o blanca tras dos o tres minutos, o se queda así hasta que pulsas F11 o F5, sigue estos puntos en orden.
1. Actualiza a la versión 1.87.14 o posterior. Acorta la fase blanca en las Pi pequeñas (los feeds de calendario ya no se sincronizan todos durante el primer minuto tras el arranque), hace que la comprobación de arranque espere al escritorio y corrige una ventana del navegador que sale demasiado pequeña. En la aplicación de control: Ajustes → Avanzado → Versión & licencia, y luego actualiza.
2. Prueba F11. Con un teclado conectado a la Pi, pulsa F11. Si aparece el diseño, la ventana del navegador arrancó más pequeña que la pantalla. Por SSH en su lugar:
3. Ejecuta la comprobación. No cambia nada y no muestra contraseñas: informa de tu modelo de Pi, el tipo de escritorio, cómo se lanza el navegador al arrancar y si esa línea de lanzamiento apunta a un archivo que existe.
En una versión anterior a la 1.87.14, ese archivo aún no está en tu Pi; esto descarga y ejecuta la misma comprobación:
4. Si la comprobación dice que una línea de arranque apunta a un archivo que falta, la pantalla nunca arranca tras un reinicio porque el lanzador que nombra ya no existe (ocurre en una Pi cuya carpeta del proyecto se renombró o se movió). Volver a ejecutar el instalador lo repara y se puede repetir sin riesgo:
Entra y sal de la pantalla completa sin pelearte con un navegador que se relanza solo.
kiosk toggle: no hace falta SSH para el uso habitual. (Las instalaciones más antiguas pueden tener todavía la asociación anterior Super+K, que resultó chocar con el gesto «toca Super para abrir el menú» del propio escritorio de Raspberry Pi; volver a ejecutar install.sh añade Ctrl+Alt+K a su lado sin quitar la antigua). Los comandos de abajo detienen limpiamente el proceso subyacente en ambos casos y son la única opción en un dispositivo sin teclado. Si estás físicamente junto a la Pi sin acceso SSH y necesitas un terminal, Ctrl+Alt+F2 cambia a una consola de texto por debajo de toda la sesión gráfica: inicia sesión ahí y ejecuta kiosk off.Para recuperarlo:
O simplemente alterna entre los dos:
kiosk restart deja una pantalla negra o te cierra la sesión del escritorio, el comando kiosk de tu Pi es una copia antigua. El instalador lo copiaba una sola vez en una carpeta del sistema, y las actualizaciones no pueden refrescar un archivo ahí, así que las correcciones nunca llegaban al comando que escribes (ni al atajo Ctrl+Alt+K). Las instalaciones más recientes enlazan automáticamente a la copia actualizada; en una más antigua, ejecuta esto una vez (te pedirá la contraseña de tu Pi):Hasta entonces, la copia actual siempre funciona si la ejecutas por su ruta completa:
Ver sus registros en directo (útil si algo realmente está roto):
Reiniciarla (p. ej., después de cambiar un ajuste manualmente):
¿Sigues atascado? Ponte en contacto : indica qué ejecutaste y qué pasó realmente, y normalmente se arregla rápido.