Sysadmin Handbook

Sysadmin Handbook v2.0.0 — a thorough sysops toolkit for system administrators. Record, track, and manage all aspects of system administration from the command line. Every action is timestamped and logged locally for full auditability.

Why Sysadmin Handbook?

• Works entirely offline — your data never leaves your machine
• Simple command-line interface, no GUI needed
• Timestamped logging for every operation
• Export to JSON, CSV, or plain text anytime
• Automatic history and activity tracking
• Searchable records across all operation types

Getting Started

# See all available commands
sysadmin-handbook help

# Check current health status
sysadmin-handbook status

# View summary statistics
sysadmin-handbook stats

Commands

Operations Commands

Each command works in two modes: run without arguments to view recent entries, or pass input to record a new entry.

Utility Commands

Data Storage

All data is stored locally in ~/.local/share/sysadmin-handbook/. Structure:

• scan.log, monitor.log, report.log, etc. — one log file per command, pipe-delimited (timestamp|value)
• history.log — unified activity log across all commands
• export.json / export.csv / export.txt — generated export files

Each entry is stored as YYYY-MM-DD HH:MM|. Use export to back up your data anytime.

Requirements

• Bash 4+ (uses set -euo pipefail)
• Standard Unix utilities (date, wc, du, tail, grep, sed, cat)
• No external dependencies or internet access needed

When to Use

1. Incident response tracking — Log scan results, alerts, and fixes during an active incident so you have a complete timeline for the post-mortem
2. Daily ops journaling — Record monitoring observations, health checks, and cleanup tasks as you go through your sysadmin routine
3. Backup & restore auditing — Track every backup and restore operation with timestamps to prove compliance or diagnose failures
4. Performance benchmarking — Store benchmark results over time and use compare to track regressions or improvements across deploys
5. Team handoff documentation — Log everything during your shift so the next admin can run recent or search to get up to speed instantly

Examples

# Record a network scan result
sysadmin-handbook scan "192.168.1.0/24 — 14 hosts up, 3 with open SSH"

# Log a monitoring observation
sysadmin-handbook monitor "web-prod-01 CPU at 92% for 15 minutes"

# Document a fix you applied
sysadmin-handbook fix "Increased nginx worker_connections from 1024 to 4096"

# Track a backup operation
sysadmin-handbook backup "Full backup of /data completed — 48GB, 23 min"

# Export everything to JSON for archival
sysadmin-handbook export json

# Search all logs for a keyword
sysadmin-handbook search "nginx"

# View recent activity across all commands
sysadmin-handbook recent

Output

All commands output to stdout. Redirect to a file if needed:

sysadmin-handbook stats > report.txt
sysadmin-handbook export csv

Configuration

Set SYSADMIN_HANDBOOK_DIR environment variable to override the default data directory (~/.local/share/sysadmin-handbook/).

Powered by BytesAgain | bytesagain.com | hello@bytesagain.com