Troubleshooting

Commands for after setup

Everything here runs on the Pi itself — either directly, or over SSH from another computer (ssh [email protected], or whatever hostname you set). 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 ~/pi-calendar/setup-remote-access.sh

Already set up? Check its status:

bash ~/pi-calendar/setup-remote-access.sh --status

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 ~/pi-calendar/install.sh
Don't re-run the one-line curl | bash install command once ~/pi-calendar 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.

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 pi-calendar

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

journalctl -u pi-calendar -f

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

sudo systemctl restart pi-calendar

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