Troubleshooting

Commands for after setup

Everything here runs on the Pi itself — either directly, or over SSH from another computer (ssh pi@raspberrypi.local, or whatever hostname you set) or a phone using an SSH app like Termius or PiSSH. Tap the icon on any command to copy it.

Add remote access

Reach the control app from anywhere, not just your home network — sets up Tailscale, a private network (nothing exposed publicly). This is interactive: it'll show you a login link to open once in any browser.

bash ~/piazzahq/setup-remote-access.sh

Already set up? Check its status:

bash ~/piazzahq/setup-remote-access.sh --status
Once this is set up, you can also SSH in from your phone — an app like Termius or PiSSH works well — using the same address Tailscale gives the Pi, no different from SSHing in from a computer.

Switch to X11

The installer offers this automatically near the end of setup. If you skipped it, or want to do it manually:

sudo raspi-config nonint do_wayland W1 && sudo reboot
If that doesn't work on your image, do it through the menu instead: sudo raspi-config → 6 Advanced Options → Wayland → W1 X11 → reboot.

Setup didn't finish, or something went wrong

Safe to run again as many times as needed — it won't repeat steps that already succeeded, and never touches your actual data (events, photos, chores).

bash ~/piazzahq/install.sh
Don't re-run the one-line curl | bash install command once ~/piazzahq already exists — it refuses on purpose, specifically so it can't be used to accidentally wipe a real install. The command above is the one that's actually safe to repeat.

Kiosk display controls

Drop in and out of the fullscreen display without racing an auto-relaunching browser.

Current installs bind Ctrl+Alt+K automatically to kiosk toggle — no SSH needed for routine use. (Older installs may still have the previous Super+K binding, which turned out to conflict with the Raspberry Pi desktop's own "tap Super to open the menu" gesture — re-running install.sh adds Ctrl+Alt+K alongside it without removing the old one.) The commands below stop the underlying process cleanly either way, and are the only option if you're on a device with no keyboard at all. If you're physically at the Pi with no SSH access and need a terminal, Ctrl+Alt+F2 switches to a text console below the whole graphical session — log in there and run kiosk off.
kiosk off

Bring it back:

kiosk on

Or just flip between the two:

kiosk toggle

Check whether the app is actually running

sudo systemctl status piazzahq

Watch its logs live (useful if something's actually broken):

journalctl -u piazzahq -f

Restart it (e.g. after manually changing a setting):

sudo systemctl restart piazzahq

Still stuck? Get in touch — include what you ran and what actually happened, and it's usually a quick fix.