42 lines
1.2 KiB
Markdown
42 lines
1.2 KiB
Markdown
# Pi-Kit quick rescue (offline note)
|
||
|
||
Keep this handy if the web dashboard is down. You’re already in via SSH, so here’s 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
|
||
```bash
|
||
sudo systemctl status nginx pikit-api # check
|
||
sudo systemctl restart nginx pikit-api # restart both
|
||
```
|
||
|
||
## Logs to inspect
|
||
```bash
|
||
sudo tail -n 100 /var/log/nginx/error.log
|
||
sudo tail -n 100 /var/log/pikit-api.log
|
||
```
|
||
|
||
## Check system health
|
||
```bash
|
||
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 won’t start
|
||
```bash
|
||
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.
|