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

# 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

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

Pi Admin