Introduction
# Raspberry Pi Administration
Complete system monitoring and introspection for the Raspberry Pi host. Access network details, system resources, storage, services, and more.
## When to Use - Checking Pi network configuration (IP, Tailscale) - Monitoring system resources (CPU, memory, storage) - Viewing running services and their status - Checking temperature and hardware info - Troubleshooting system issues - Getting system overview for debugging
## Usage
```bash # Information Commands cd /home/srose/clawd/skills/pi-admin ./skill.sh overview ./skill.sh network ./skill.sh tailscale ./skill.sh resources ./skill.sh storage ./skill.sh services ./skill.sh hardware
# Maintenance Commands ./skill.sh update # Update system packages ./skill.sh clean # Clean unused packages, logs, Docker ./skill.sh reboot # Reboot with countdown ./skill.sh restart-gateway # Restart the Clawdis Gateway
# Complete system info ./skill.sh all ```
## Tools Available
| Tool | Description | |------|-------------| | `overview` | Quick system summary | | `network` | IP addresses, hostname, network interfaces | | `tailscale` | Tailscale status, IP, peers | | `resources` | CPU, memory, temperature | | `storage` | Disk usage, mount points | | `services` | Running services, Gateway status | | `hardware` | CPU info, Raspberry Pi model, GPU | | `all` | Complete detailed dump |
## Examples
```bash # Quick system check ./skill.sh overview
# Debug network issues ./skill.sh network && ./skill.sh tailscale
# Check if Gateway is running ./skill.sh services | grep gateway
# Monitor disk space ./skill.sh storage ```
## Information Collected
**Network:** - Hostname - Local IP addresses (eth0, wlan0) - Network interface details - DNS configuration
**Tailscale:** - Status (running/stopped) - Tailscale IP - Connected peers - Exit node status
**Resources:** - CPU usage - Memory usage (used/free/total) - CPU temperature - Uptime
**Storage:** - Disk usage by mount point - Inode usage - Free space
**Services:** - Gateway service status - Docker containers - Systemd services - Port listeners
**Hardware:** - CPU model and cores - Raspberry Pi model - GPU memory - Total RAM
## Maintenance Commands
### `update` Update system packages via apt: - Updates package lists - Shows upgradable packages - Requires confirmation before upgrading - Reports if reboot is needed - **Dry run:** `./skill.sh update --dry-run` shows what would be updated
### `clean` Clean up system to free disk space: - Removes unused packages (autoremove) - Clears package cache - Cleans old journal logs (keeps 7 days) - Optionally cleans Docker artifacts - Shows space saved - **Dry run:** `./skill.sh clean --dry-run` shows what would be cleaned
### `reboot` Graceful system reboot: - 10-second countdown - Ctrl+C to cancel - Uses systemctl reboot - **Dry run:** `./skill.sh reboot --dry-run` shows countdown without rebooting
### `restart-gateway` Restart the Clawdis Gateway service: - Stops all running gateway processes - Starts fresh gateway on port 18789 - Confirms port is listening - Shows access URLs - **Dry run:** `./skill.sh restart-gateway --dry-run` shows what would happen
### `optimize` Apply safe system optimizations: - Disable Bluetooth service (~50MB RAM saved) - Disable ModemManager (~30MB RAM saved) - Disable Avahi/Zeroconf (~20MB RAM saved) - Set swappiness to 10 (better RAM utilization) - **Dry run:** `./skill.sh optimize --dry-run` shows what would change - **Undo:** `./skill.sh optimize --undo` reverts all changes
**Total RAM savings:** ~100MB **Reversibility:** Yes, use `--undo` flag to revert
**Note:** All maintenance commands require sudo and ask for confirmation before making changes. Use `--dry-run` flag to preview changes without applying them.