Files
pi-kit/pikit-web/RESCUE.md
2025-12-10 18:51:31 -05:00

1.2 KiB
Raw Blame History

Pi-Kit quick rescue (offline note)

Keep this handy if the web dashboard is down. Youre already in via SSH, so heres what to check next.

Where to find this note

  • /root/RESCUE.md
  • /home/dietpi/RESCUE.md
  • /var/www/pikit-web/RESCUE.md

Fast service reset

sudo systemctl status nginx pikit-api          # check
sudo systemctl restart nginx pikit-api         # restart both

Logs to inspect

sudo tail -n 100 /var/log/nginx/error.log
sudo tail -n 100 /var/log/pikit-api.log

Check system health

df -h                                          # disk space
free -h                                        # memory
sudo systemctl status unattended-upgrades      # auto-update service
sudo systemctl status apt-daily.timer apt-daily-upgrade.timer

If services wont start

sudo nginx -t                                  # validate nginx config
sudo journalctl -u nginx -u pikit-api -n 100   # detailed service logs

Licenses (for distribution)

  • /var/www/pikit-web/LICENSE (MIT for Pi-Kit)
  • /var/www/pikit-web/THIRD-PARTY-LICENSES.md
  • /var/www/pikit-web/assets/fonts/OFL.txt

Tip: after any change, sudo systemctl restart nginx pikit-api then re-check logs above.