Pi Admin

# 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.